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CHAPTER  1 


INTRODUCTION 


The  Ada  implementation  described  above  was  tested  according  to  the  Ada 
Validation  Procedures  (Pro90]  against  the  Ada  Standard  [Ada83]  using  the 
current  Ada  Compiler  Validation  Capability  (ACVC).  This  Validation  Summary 
Report  (VSR)  gives  an  account  of  the  testing  of  this  Ada  implementation. 

For  any  technical  terms  used  in  this  report,  the  reader  is  referred  to 
[Pro90].  A  detailed  description  of  the  ACVC  may  be  found  in  the  current 
ACVC  User's  Guide  [UG89]. 


1.1  USE  OF  THIS  VALIDATION  SUMMARY  REPORT 

Consistent  with  the  national  laws  of  the  originating  country,  the  Ada 
Certification  Body  may  make  full  and  free  public  disclosure  of  this  report. 
In  the  United  States,  this  is  provided  in  accordance  with  the  "Freedom  of 
Information  Act"  (5  U.S.C.  #552).  The  results  of  this  validation  apply 
only  to  the  computers,  operating  systems,  and  compiler  versions  identified 
in  this  report. 

The  organizations  represented  on  the  signature  page  of  this  report  do  not 
represent  or  warrant  that  all  statements  set  forth  in  this  report  are 
accurate  and  complete,  or  that  the  subject  implementation  has  no 
nonconformities  to  the  Ada  Standard  other  than  those  presented.  Copies  of 
this  report  are  available  to  the  public  from  the  AVF  which  performed  this 
validation  or  from: 

National  Technical  Information  Service 
5285  Port  Royal  Road 
Springfield  VA  22161 

Questions  regarding  this  report  or  the  validation  test  results  should  be 
directed  to  the  AVF  which  performed  this  validation  or  to: 

Ada  Validation  Organization 

Computer  and  Software  Engineering  Division 

Institute  for  Defense  Analyses 

1801  North  Beauregard  Street 

Alexandria  VA  22311-1772 
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1.2  REFERENCES 

[Ada83]  Reference  Manual  for  the  Ada  Programming  Language, 

ANSI/MI L-STD-1815A,  February  1983  and  ISO  8652-1987. 

|Pro90]  Ada  Compiler  Validation  Procedures,  Version  2.1,  Ada  Joint 
Program  Office,  August  1990. 

IUG89J  Ada  Compiler  Validation  Capability  User's  Guide,  21  June  1989. 


1.3  ACVC  TEST  CLASSES 

Compliance  of  Ada  implementations  is  tested  by  mean s  of  the  ACVC.  The  ACVC 
contains  a  collection  of  test  programs  structured  into  six  test  classes:  A, 
B,  C,  D,  E,  and  L.  The  first  letter  of  a  test  name  identifies  the  class  to 
which  it  belongs.  Class  A,  C,  D,  and  E  tests  are  executable.  Class  B  and 
class  L  tests  are  expected  to  produce  errors  at  compile  time  and  link  time, 
respectively. 

The  executable  tests  are  written  in  a  self-checking  manner  and  produce  a 
PASSED,  FAILED,  or  NOT  APPLICABLE  message  indicating  the  result  when  they 
are  executed.  Three  Ada  library  units,  the  packages  REPORT  and  SPPRT13, 
and  the  procedure  CHECK  FILE  are  used  for  this  purpose.  The  package  REPORT 
also  provides  a  set  of  Identity  functions  used  to  defeat  some  compiler 
optimizations  allowed  by  the  Ada  Standard  that  would  circumvent  a  test 
objective.  The  package  SPPRT13  is  used  by  many  tests  for  Chapter  13  of  the 
Ada  Standard.  The  procedure  CHECK_FILE  is  used  to  check  the  contents  of 
text  files  written  by  some  of  the  Class  C  tests  for  Chapter  14  of  the  Ada 
Standard.  The  operation  of  REPORT  and  CBECK_FILE  is  checked  by  a  set  of 
executable  tests.  If  these  units  are  not  operating  correctly,  validation 
testing  is  discontinued. 

Class  B  tests  check  that  a  compiler  detects  illegal  language  usage.  Class 
B  tests  are  not  executable.  Each  test  in  this  class  is  compiled  and  the 
resulting  compilation  listing  is  examined  to  verify  that  all  violations  of 
the  Ada  Standard  are  detected.  Some  of  the  class  B  tests  contain  legal  Ada 
code  which  must  not  be  flagged  illegal  by  the  compiler.  This  behavior  is 
also  verified. 

Class  L  tests  check  that  an  Ada  implementation  correctly  detects  violation 
of  the  Ada  Standard  involving  multiple,  separately  compiled  units.  Errors 
are  expected  at  link  time,  and  execution  is  attempted. 

In  some  tests  of  the  ACVC,  certain  macro  strings  have  to  be  replaced  by 
implementation-specific  values  —  for  example,  the  largest  integer.  A  list 
of  the  values  used  for  this  implementation  is  provided  in  Appendix  A.  in 
addition  to  these  anticipated  test  modifications,  additional  changes  may  be 
required  to  remove  unforeseen  conflicts  between  the  tests  and 
implementation-dependent  characteristics.  The  modifications  required  for 
this  implementation  are  described  in  section  2.3. 
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For  each  Ada  implementation,  a  customized  test  suite  is  produced  by  the 
AVF.  This  customization  consists  of  making  the  modifications  described  in 
the  preceding  paragraph,  removing  withdrawn  tests  (see  section  2.1),  and 
possibly  removing  some  inapplicable  tests  (see  section  2.2  and  [UG89]). 

In  order  to  pass  an  ACVC  an  Ada  implementation  must  process  each  test  of 
the  customized  test  suite  according  to  the  Ada  Standard. 


1.4  DEFINITION  OF  TERMS 

Ada  Compiler  The  software  and  any  needed  hardware  that  have  to  be  added 
to  a  given  host  and  target  computer  system  to  allow 
transformation  of  Ada  programs  into  executable  form  and 
execution  thereof. 

Ada  Compiler  The  means  for  testing  compliance  of  Ada  implementations, 
Validation  consisting  of  the  test  suite,  the  support  programs,  the  ACVC 

Capability  user's  guide  and  the  template  for  the  validation  summary 

(ACVC)  report. 

Ada  An  Ada  compiler  with  its  host  computer  system  and  its 

Implementation  target  computer  system. 

Ada  Joint  The  part  of  the  certification  body  which  provides  policy  and 

Program  guidance  for  the  Ada  certification  system. 

Office  (AJPO) 

Ada  The  part  of  the  certification  body  which  carries  out  the 

Validation  procedures  required  to  establish  the  compliance  of  an  Ada 
Facility  (AVF)  implementation. 

Ada  The  part  of  the  certification  body  that  provides  technical 

Validation  guidance  for  operations  of  the  Ada  certification  system. 

Organization 
(AVO) 

Compliance  of  The  ability  of  the  implementation  to  pass  an  ACVC  version, 
an  Ada 

Implementation 

Computer  A  functional  unit,  consisting  of  one  or  more  computers  and 

System  associated  software,  that  uses  common  storage  for  all  or 

part  of  a  program  and  also  for  all  or  part  of  the  data 
necessary  for  the  execution  of  the  program;  executes 
user-written  or  user-designated  programs;  performs 
user-designated  data  manipulation,  including  arithmetic 
operations  and  logic  operations;  and  that  can  execute 
programs  that  modify  themselves  during  execution.  A 
computer  system  may  be  a  stand-alone  unit  or  may  consist  of 
several  inter-connected  units. 
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Conformity 


Customer 


Declaration  of 
Conformance 


Host  Computer 
System 

Inapplicable 

test 

ISO 

LRM 


Operating 

System 


Target 

Computer 

System 

Validated  Ada 
Compiler 

Validated  Ada 
Implementation 

Validation 


Withdrawn 

test 


Fulfillment  by  a  product,  process,  or  service  of  all 
requirements  specified. 

An  individual  or  corporate  entity  who  enters  into  an 
agreement  with  an  AVF  which  specifies  the  terms  and 
conditions  for  AVF  services  (of  any  kind)  to  be  performed. 

A  formal  statement  from  a  customer  assuring  that  conformity 
is  realized  or  attainable  on  the  Ada  implementation  for 
which  validation  status  is  realized. 

A  computer  system  where  Ada  source  programs  are  transformed 
into  executable  form. 

A  test  that  contains  one  or  more  test  objectives  found  to  be 
irrelevant  for  the  given  Ada  implementation. 

International  Organization  for  Standardization. 

The  Ada  standard,  or  Language  Reference  Manual,  published  as 
ANSI/MIL- STD-1815A-1983  and  ISO  8652-1987.  Citations  from 
the  LRM  take  the  form  "<section>.<subsection>:<paragraph>." 

Software  that  controls  the  execution  of  programs  and  that 
provides  services  such  as  resource  allocation,  scheduling, 
input/output  control,  and  data  management.  Usually, 
operating  systems  are  predominantly  software,  but  partial  or 
complete  hardware  implementations  are  possible. 

A  computer  system  where  the  executable  form  of  Ada  programs 
are  executed. 


The  compiler  of  a  validated  Ada  implementation. 


An  Ada  implementation  that  has  been  validated  successfully 
either  by  AVF  testing  or  by  registration  lPro90J. 

The  process  of  checking  the  conformity  of  an  Ada  compiler  to 
the  Ada  programming  language  and  of  issuing  a  certificate 
for  this  implementation. 

A  test  found  to  be  incorrect  and  not  used  in  conformity 
testing.  A  test  may  be  incorrect  because  it  has  an  invalid 
test  objective,  fails  to  meet  its  test  objective,  or 
contains  erroneous  or  illegal  use  of  the  Ada  programming 
language . 
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IMPLEMENTATION  DEPENDENCIES 


2.1  WITHDRAWN  TESTS 


The  following  tests  have  been  withdrawn  by  the  AVO.  The  rationale  for 
withdrawing  each  test  is  available  from  either  the  AVO  or  the  AVF.  The 


publication 

date  for  this 

list  of  withdrawn  tests 

is  3  May  1991 

• 

E28005C 

B28006C 

C34006D 

C35508I 

C35508J 

C35508M 

C35508N 

C35702A 

C35702B 

B41308B 

C43004A 

C45114A 

C45346A 

C45612A 

C45612B 

C45612C 

C45651A 

C46022A 

B49008A 

B49008B 

A74006A 

C74308A 

B83022B 

B83022H 

B83025B 

B83025D 

C83026A 

B83026B 

C83041A 

B85001L 

C86001F 

C94021A 

C97116A 

C98003B 

BA2011A 

CB7001A 

CB7001B 

CB7004A 

CC1223A 

BC1226A 

CC1226B 

BC3009B 

BD1B02B 

BD1B06A 

AD1B08A 

BD2A02A 

CD2A21E 

CD2A23E 

CD2A32A 

CD2A41A 

CD2A41E 

CD2A87A 

CD2B15C 

BD3006A 

BD4008A 

CD4022A 

CD4022D 

CD4024B 

CD4024C 

CD4024D 

CD4031A 

CD4051D 

CD5111A 

CD7004C 

ED7005D 

CD7005E 

AD7006A 

CD7006E 

AD7201A 

AD7201E 

CD7204B 

AD7206A 

BD8002A 

BD8004C 

CD9005A 

CD9005B 

CDA201E 

CE2107I 

CE2117A 

CE2117B 

CE2119B 

CE2205B 

CE2405A 

CE3111C 

CE3116A 

CE3118A 

CE3411B 

CE3412B 

CE3607B 

CE3607C 

CE3607D 

CE3812A 

CE3814A 

CE3902B 

2.2  INAPPLICABLE  TPSTS 

A  test  is-  inapplicable  if  it  contains  test  objectives  which  are  irrelevant 
for  a  given  Ada  implementation.  Reasons  for  a  test's  inapplicability  may 
be  supported  by  documents  issued  by  the  ISO  and  the  AJPO  known  as  Ada 
Commentaries  and  commonly  referenced  in  the  format  Al-ddddd.  For  this 
implementation,  the  following  tests  were  determined  to  be  inapplicable  for 
the  reasons  indicated;  references  to  Ada  Commentaries  are  included  as 
appropriate. 


2-1 


IMPLEMENTATION  DEPENDENCIES 


The  following  201  tests  have  floating-point  type  declarations 
requiring  more  digits  than  SYSTEM. MAX_DIGITS: 

C24113L..Y  (14  tests)  C35705L..Y  (14  tests) 

C35706L. . Y  (14  tests)  C35707L..Y  (14  tests) 

C35708L..Y  (14  tests)  C35802L..Z  (15  tests) 

C45241L..Y  (14  tests)  C45321L..Y  (14  tests) 

C45421L..Y  (14  tests)  C45521L..Z  (15  tests) 

C45524L. . Z  (15  tests)  C45621L..Z  (15  tests) 

C45641L..Y  (14  tests)  C46012L..Z  (15  tests) 

The  following  20  tests  check  for  the  predefined  type  LONG_INT£GER;  for 
this  implementation,  there  is  no  such  type: 


C35404C 

C45231C 

C45304C 

C45411C 

C45412C 

C45502C 

C45503C 

C45504C 

C45504F 

C45611C 

C45613C 

C45614C 

C45631C 

C45632C 

B52004D 

C55B07A 

B55B09C 

B86001V 

C86006C 

CD7101F 

C35404D,  C45231D,  B86001X,  C86006E,  and  CD7101G  check  for  a  predefined 
integer  type  with  a  name  other  than  INTEGER,  LONG_INTEGER,  or 
SHORT_INTEGER;  for  this  implementation,  there  is  no  such  type. 


C35713B,  C45423B,  B86001T,  and  C86006H  check  for  the  predefined  type 
SH0RT_FL0AT;  for  this  implementation,  there  is  no  such  type. 

C35713D  and  B86001Z  check  for  a  predefined  floating-point  type  with  a 
name  other  than  FLOAT,  L0NGFL0AT,  or  SH0RT_FL0AT ;  for  this 
implementation,  there  is  no  such  type. 

C45423A,  C45523A,  and  C45622A  check  that  the  proper  exception  is 
raised  if  MACHINE_0VERFL0WS  is  TRUE  and  the  results  of  various 
floating-point  .  operations  lie  outside  the  range  of  the  base  type;  for 
this  implementation,  MACHINEOVERFLOWS  is  FALSE. 

C45531M..P  and  C45532M..P  (8  tests)  check  fixed-point  operations  for 
types  that  require  a  SYSTEM. MAXMANTISSA  of  47  or  greater;  for  this 
implementation,  MAX_MANTISSA  is  less  than  47. 

B86001Y  uses  the  name  of  a  predefined  fixed-point  type  other  than  type 
DURATION;  for  this  implementation,  there  is  no  such.  type. 

CA2009C  and  CA2009F  check  whether  a  generic  unit  can  be  instantiated 
before  its  body  (and  any  of  its  subunits)  is  compiled;  this 
implementation  creates  a  dependence  on  generic  units  as  allowed  by 
AI-00408  and  AI-00506  such  that  the  compilation  of  the  generic  unit 
bodies  makes  the  instantiating  units  obsolete.  (See  section  2.3.) 

CD1009C  checks  whether  a  length  clause  can  specify  a  non-default  size 
for  a  floating-point  type;  this  implementation  does  not  support  such 
sizes. 
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CD2A84A,  CD2A84E,  CD2A84I..J  (2  tests),  and  CD2A840  use  length  clauses 
to  specify  non-default  sizes  for  access  types;  this  implementation 
does  not  support  such  sizes. 

BD8001A,  BD8003A,  BD8004A..B  (2  tests),  and  AD8011A  use  machine  code 
insertions;  this  implementation  provides  no  package  MACHINE_CODE . 

AE2101H,  EE2401D,  and  EE2401G  use  instantiations  of  package  DIRECT_I0 
with  unconstrained  array  types  and  record  types  with  discriminants 
without  defaults;  these  instantiations  are  rejected  by  this  compiler. 

The  tests  listed  in  the  following  table  check  that  USE_ERROR  is  raised 
if  the  given  file  operations  are  not  supported  for  the  given 
combination  of  mode  and  access  method;  this  implementation  supports 
these  operations. 


Test 

File  Operation  Mode 

File  Access  Method 

CE2102D 

CREATE 

IN  FILE 

SEQUENTIAL  10 

CE2102E 

CREATE 

OUT  FILE 

SEQUENTIAL  10 

CE2102F 

CREATE 

INOUT  FILE 

DIRECT  10 

CE2102I 

CREATE 

IN  FILE 

DIRECT  10 

CE2102J 

CREATE 

OUT  FILE 

DIRECT- 10 

CE2102N 

OPEN 

IN  FILE 

SEQUENTIAL  10 

CE21020 

RESET 

IN  FILE 

SEQUENTIAL  10 

CE2102P 

OPEN 

OUT  FILE 

SEQUENTIAL- 10 

CE2102Q 

RESET 

OUT"FILE 

SEQUENTIAL~IO 

CE2102R 

OPEN 

INOUT  FILE 

DIRECT  10 

CE2102S 

RESET 

INOUT  FILE 

DIRECT  10 

CE2102T 

OPEN 

IN  FILE 

DIRECT-I0 

CE2102U 

RESET 

IN  FILE 

DIRECT  10 

CE2102V 

OPEN 

OUT  FILE 

DIRECT~I0 

CE2102W 

.RESET 

OUT  FILE 

DIRECT  10 

CE3102E 

CREATE 

IN  FILE 

TEXT  10 

CE31Q2F 

RESET 

Any  Mode 

TEXT  10 

CE3102G 

DELETE 

TEXT  10 

CE3102I 

CREATE 

OUT  FILE 

TEXT  10 

CE3102J 

OPEN 

IN  FILE 

TEXT  10 

CE3102K 

OPEN 

OUT  FILE 

TEXT  10 

The  following  16  tests  check  operations  on  sequential,  direct,  and 
text,  files  when  multiple  internal  files  are  associated  with  the  same 
external  file  and  one  or  more  are  open  for  writing;  USE  ERROR  is 
raised  when  this  association  is  attempted. 


CE2107B..E 

CE2107G..H 

CE2107L 

CE2110B 

CE2110D 

CE2111D 

CE3115A 

CE2111R 

CE3111B 

CE3111D..E 

CE3114B 
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CE2203A  checks  that  WRITE  raises  USEJERROR  if  the  capacity  of  an 
external  sequential  file  is  exceeded;  this  implementation  cannot 
restrict  file  capacity. 

CE2403A  checks  that  WRITE  raises  USE_ERROR  if  the  capacity  of  an 
external  direct  file  is  exceeded;  this  implementation  cannot  restrict 
file  capacity. 

CE3413B  checks  that  PAGE  raises  LAYOUT_ERROR  when  the  value  of  the 
page  number  exceeds  COUNT' LAST;  for  this  Implementation,  the  value  of 
COUNm' LAST  is  greater  than  150000,  making  the  checking  of  this 
objective  impractical. 

LA3004A. .B,  EA3004C..D,  and  CA3004E..F  (6  tests)  check  pragma  INLINE 
for  procedures  and  functions;  this  implementation  does  not  support 
pragma  INLINE. 


2.3  TEST  MODIFICATIONS 

Modif ications  (see  section  1.3)  were  required  for  28  tests. 

The  following  tests  were  split  into  two  or  more  tests  because  this 
implementation  did  not  report  the  violations  of  the  Ada  Standard  in  the 
way  expected  by  the  original  tests. 

BA1001A1  BA2001C  BA2001E2  BA3006A6M  BA3006B3 

BA3007B7  BA3008A4  BA3008B5  BA3013A6  BA3013A7M 


C52008B  was  graded  passed  by  Test  Modification  as  directed  by  the  AVO. 
This  test  uses  a  record  type  with  discriminants  with  defaults;  this  test 
also  has  array  components  whose  length  depends  on  the  values  of  some 
discriminants  of  type  INTEGER.  The  test  was  modified  to  constrain  the 
subtype  of  the  discriminants.  Line  16  was  modified  to  declare  a 
constrained  subtype  of  INTEGER,  and  discriminant  declarations  in  lines  17 
and  25  were  modified  to  use  that  subtype;  the  lines  are  given  below: 

16  SUBTYPE  SUBINT  IS  INTEGER  RANGE  -128  ..  127; 

17  TYPE  REC1(D1,D2  :  SUBINT)  IS 

25  TYPE  REC2(D1,D2,D3,D4  :  SUBINT  :=  0)  IS 


CA2009C  and  CA2009F  were  graded  inapplicable  by  Evaluation  Modification  as 
directed  by  the  AVO.  These  tests  contain  instantiations  of  a  generic  unit 
prior  to  the  compilation  of  that  unit's  body;  as  allowed  by  AI-00408  and 
AI-00506 ,  the  compilation  of  the  generic  unit  bodies  makes  the  compilation 
unit  that  contains  the  instantiations  obsolete. 
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BC3204C  and  BC3205D  were  graded  passed  by  Processing  Modification  as 
directed  by  the  AVO.  These  tests  check  that  instantiations  of  generic 
units  with  unconstrained  types  as  generic  actual  parameters  are  illegal  if 
the  generic  bodies  contain  uses  of  the  types  that  require  a  constraint. 
However,  the  generic  bodies  are  compiled  after  the  units  that  contain  the 
instantiations,  and  this  implementation  creates  a  dependence  of  the 
instantiating  units  on  the  generic  units  as  allowed  by  AI-00408  and 
AI-00506  such  that  the  compilation  of  the  generic  bodies  makes  the 
instantiating  units  obsolete — no  errors  are  detected.  The  processing  of 
these  tests  was  modified  by  re-compiling  the  obsolete  units;  all  intended 
errors  were  then  detected  by  the  compiler. 

CD1009A,  CD1009I ,  CD1C03A,  CD2A21C,  CD2A24A,  CD2A31A,  CD2A31B,  CD2A31C 
were  graded  passed  by  Evaluation  Modification  as  directed  by  the  AVO. 

These  tests  use  instantiations  of  the  support  procedure  LENGTH_CHECK, 
which  uses  Unchecked_Conversion  according  to  the  interpretation  given  in 
AI-00590.  The  AVO  ruled  that  this  interpretation  is  not  binding  under 
ACVC  1.11;  the  tests  are  ruled  to  be  passed  if  they  produce  Failed 
messages  only  from  the  instances  of  LENGTH_CHECK — i.e,  the  allowed 
Report. Failed  messages  have  the  general  form: 

"  *  CHECK  ON  REPRESENTATION  FOR  <TYPE  ID>  FAILED." 


EE3301B,  EE3405B,  and  EE3410F  were  graded  passed  by  Evaluation 
Modification  as  directed  by  the  AVO.  These  tests  check  certain  I/O 
operations  on  the  current  default  output  file,  including  standard  output. 
This  implementation  outputs  the  ASCII  form-feed  character  which  has  no 
effect  on  the  standard  IBM  output  devices;  in  general,  there  is  no  common 
form-feed  mechanism  for  the  devices.  Thus,  the  printed  output  from  this 
test  did  not  contain  the  expected  page  breaks.  The  AVO  ruled  that  these 
tests  should  be  considered  passed  if  none  of  the  tests'  internal  checks 
was  failed  (i.e.,  if  the  tests  report  "TENTATIVELY  PASSED"). 

CE2103C..D  (2  tests)  were  graded  passed  by  Test  Modification  as  directed 
by  the  AVO.  These  tests  close  an  empty  file;  however,  the  IBM  VM/SP  HPO 
(CMS)  operating  system  does  not  allow  an  empty  file  to  exist,  and  so  the 
file  is  deleted  and  USE_ERROR  is  raised.  The  AVO  ruled  that  this  behavior 
is  acceptable,  given  thi  operating  system  (cf.  AI-00325);  the  AVO 
directed  that  the  tests  be  modified  and  passed  with  the  following  write 
statement  inserted  into  the  two  tests,  respectively,  at  lines  56  and  55: 

WRITE  ( TE ST_F I LE_0NE ,  'A'); 
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PROCESSING  INFORMATION 


3.1  TESTING  ENVIRONMENT 


The  Ada  implementation  tested  in  this  validation  effort  is  described 
adequately  by  the  information  given  in  the  initial  pages  of  this  report. 

For  technical  and  sales  information  about  this  Ada  implementation,  contact: 

IBM  Canada,  Ltd 
844  Don  Mills  Road 
North  York,  Ontario 
Canada  M3C  IB7 
ATTN:  Antony  Niro 

31/257/844/T0R 


Testing  of  this  Ada  implementation  was  conducted  at  the  customer's  site  by 
a  validation  team  from  the  AVF. 


3.2  SUMMARY  OF  TEST  RESULTS 

An  Ada  Implementation  passes  a  given  ACVC  version  if  it  processes  each  test 
of  the  customized  test  suite  in  accordance  with  the  Ada  Programming 
Language  Standard,  whether  the  test  is  applicable  or  inapplicable; 
otherwise,  the  Ada  Implementation  fails  the  ACVC  [Pro90]. 

For  all  processed  tests  (inapplicable  and  applicable),  a  result  was 
obtained  that  conforms  to  the  Ada  Programming  Language  Standard. 

The  list  of  items  below  gives  the  number  of  ACVC  tests  in  various 
categories.  All  tests  were  processed,  except  those  that  were  withdrawn 
because  of  test  errors  (item  b;  see  section  2.1),  those  that  require  a 
floating-point  precision  that  exceeds  the  implementation's  maximum 
precision  (item  e;  see  section  2.2),  and  those  that  depend  on  the  support 
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of  a  file  system  —  if  none  is  supported  (item  d).  All  tests  passed, 
except  those  that  are  listed  in  sections  2.1  and  2.2  (counted  in  items  b 
and  f,  below). 


a)  Total  Number  of  Applicable  Tests  3770 

b)  Total  Number  of  Withdrawn  Tests  94 

c)  Processed  inapplicable  Tests  105 

d)  Non-Processed  I/O  Tests  0 

e)  Non-Processed  Floating-Point 

Precision  Tests  201 

f)  Total  Number  of  Inapplicable  Tests  306 


g)  Total  Number  of  Tests  for  ACVC  1.11  4170 


3.3  TEST  EXECUTION 

A  magnetic  tape  containing  the  customized  test  suite  (see  section  1.3)  was 
taken  on-site  by  the  validation  team  for  processing.  The  contents  of  the 
magnetic  tape  were  loaded  directly  onto  the  host  computer. 


After  the  test  files  were  loaded  onto  the  host  computer,  the  full  set  of 
tests  was  processed  by  the  Ada  implementation. 


Testing  was  performed  using  command  scripts  provided  by  the  customer  and 
reviewed  by  the  validation  team.  See  Appendix  B  for  a  complete  listing  of 
the  processing  options  for  this  implementation.  It  also  indicates  the 
default  options.  The  options  invoked  explicitly  for  validation  testing 
during  this  test  were: 


ADA  dsname  (options) 
options 


description 


dsname  Dsname  specifies  the  file  to  be  compiled. 

ERROR(LIST)  Creates  a  listing  file  only  when  errors  are 

encountered.  file  contains  compile-time  error 

messages  interspersed  with  the  source  code. 

COMPILE  |  MAIN  |  BIND  Compile  is  the  default  option  causing  a 

compile  only.  BIND  will  be  used  in  those 
instances  for  subunits  needing  to  be 
compiled  prior  to  the  main  program.  MAIN 
is  specified  for  mains  and  will  allow 
execution  to  take  place. 
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Test  output,  coupiler  and  linker  listings,  and  job  logs  were  captured  on 
magnetic  tape  and  archived  at  the  AVF.  The  listings  examined  on-site  by 
the  validation  team  were  also  archived. 
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MACRO  PARAMETERS 

This  appendix  contains  the  macro  parameters  used  for  customizing  the  ACVC. 

The  meaning  and  purpose  of  these  parameters  are  explained  in  [UG89].  The 
parameter  values  are  presented  in  two  tables.  The  first  table  lists  the 
values  that  are  defined  in  terms  of  the  maximum  input-line  length,  vhich  is 
the  value  for  $MAX_IN_LEN— also  listed  here.  These  values  are  expressed 
here  as  Ada  string-aggregates,  where  "V"  represents  the  maximum  input-line 
length. 

Macro  Parameter  Macro  Value 

$MAX_IN_LEN  200  —  Value  of  V 

$BIG_ID1  (1..V-1  =>  'A',  V  ->  '1') 

$BIG_ID2  (1..V-1  =>  'A',  V  «>  '2') 

$BIG_ID3  (1..V/2  =>  'A')  &  '3'  &  (1..V-1-V/2  ->  'A') 

$BIG_ID4  (1..V/2  =>  'A')  &  '4'  &  (1..V-1-V/2  «>  'A') 

$BIG_INT_LIT  (1..V-3  =>  '0')  &  "298" 

$BIG_REAL_LIT  (1..V-5  =>  '0')  &  "690.0" 

$BIG_STRING1  &  (1..V/2  «>  'A')  & 

$BIG_STRING2  &  (1..V-1-V/2  *>  'A')  &  '1'  & 

$BLANKS  (1..V-20  =>  '  ' ) 

$MAX  LEN  INT_BASED  LITERAL 

“  "2:"  &  (1..V-5  =>  '0')  &  "11:" 

$MAX  LEN  REAL  BASED  LITERAL 

.  "16:"  &  (1..V-7  =>  '0')  &  "F.E:" 

$MAX_STRING_LITERAL  &  (1..V-2  =>  'A')  & 
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The  following  table  lists  all  of  the  other  macro  parameters  and  their 
respective  values. 


Macro  Parameter 

Macro  Value 

$ACC_SIZE 

32 

$ALIGNMENT 

4 

$COUNT_LAST 

2_i47_483_646 

$DEFAULT_MEM_SIZE 

16777215 

$DEFAULT_STOR_UNIT 

8 

$DEFAULT_SYS_NAME 

IBM370 

$DELTA_D0C 

2#1.0#E-31 

$ENTRY_ADDRESS 

ENT_ADDRESS 

$ENTRY_ADDRESS1 

ENT_ADDRESS1 

$ENTRY_ADDRESS2 

ENTADDRESS2 

$FIELD_LAST 

1000 

$FILE_TERMINATOR 

f  f 

$FIXED_NAME 

NO_SUCB_TYPE 

$FLOAT_NAME 

NO_SUCH_TYPE 

$F0RM_STRING 

nn 

$F0RM_STRING2 

CANN0T_RE STRI CT_FI LE_CAPACITY 

$GREATER  THAN  DURATION 

86401.0 

$GREATER  THAN  DURATION  BASE  LAST 

131073.0 

$GREATER  THAN_FL0AT  BASE  LAST 

7.237006E+75 

$GREATER  THAN_FL0AT_SAFE  LARGE 

7.I3004E+75 
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$GREATER  THAN  SHORT  FLOAT  SAFE  LARGE 

7.237E+7S 

$HIGH_PRIORITY  255 

$ILLEGAL_EXTERNAL  FILE_NAME1 

BADCHAR** 

$ILLEGAL_EXTERNAL  FILE_NAME2 

BAD-CHAR! 

$INAPPROPRIATE  LINE  LENGTH 

“  1029 

$INAPPROPRIATE  PAGE  LENGTH 

-1 

$INCLUDE_PRAGMA1  PRAGMA  INCLUDE  ("A28006D1.TST") ; 

$INCLUDE_PRAGMA2  PRAGMA  INCLUDE  ("B28006F1.TST") ; 

$INTEGER_FIRST  -2147483648 

$INTEGER_LAST  2147483647 

$INTEGER_LAST_PLUS_1  2147483648 

$INTERFACE_LANGUAGE  C 

$LESS_THAN_DURATION  -86401.0 

$LESS_THAN_DURATION_BASE_FIRST 

131073.0 

$LINE_TERMINATOR  '  ' 

$LOW__PRIORITY  0 

$MACHINE_CODE_STATEMENT 

NULL; 

$MACHINE_CODE_TYPE  NO_SUCH_TYPE 

$MANTISSA_DOC  31 

$MAX_DIGITS  15 

$MAX_INT  2147483647 

$MAX_INT_PLUS_1  2147483648 

$MIN__INT  -2147483648 

$NAME  NO_SUCH_TYPE_AVAILABLE 
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$NAME_LIST 

mc68000 ,  anuyk44 , ibm370 

$NAME_SPECIFICATIONl 

X2102A  DATA  A1 

$NAME_SPECIFICATION2 

X2102B  DATA  A1 

$NAME_SPECIFICATION3 

X3119A  DATA  A1 

$NEG_BASED_INT 

16#FFFFFFFE# 

$NEV_MEM_SIZE 

16777215 

$NEV_STOR_UNIT 

8 

$NEW_SYS_NAME 

IBM370 

$PAGE_TERMINATOR 

9  9 

$RECORD_DEFINITION 

NEW  INTEGER; 

$RECORD_NAME 

NO_SUCH_MACHINE_CODE_TYPE 

$TASK_SIZE 

32 

$TASK_STORAGE_SIZE 

1024 

$TICK 

0.000001 

$VARIABLE_ADDRESS 

VAR_ADDRESS 

$  VAR  X  AB  LE_ADDRE  SSI 

VARADDRESS1 

$VARIABLE_ADDRESS2 

VAR_ADDRESS2 

$YOUR_PRAGMA 

PRIORITY 
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COMPILATION  SYSTEM  OPTIONS 


The  compiler  options  of  this  Ada  implementation,  as  described  in  this 
Appendix,  are  provided  by  the  customer.  Unless  specifically  noted 
otherwise,  references  in  this  appendix  are  to  compiler  documentation  and 
not  to  this  report. 


LINKER  OPTIONS 

The  linker  options  of  this  Ada  implementation,  as  described  in  this 
Appendix,  are  provided  by  the  customer.  Unless  specifically  noted 
otherwise,  references  in  this  appendix  are  to  linker  documentation  and  not 
to  this  report. 
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Chapter  2.  Compiling  Ada  Programs 

This  chapter  describes  how  to  use  the  IBM  Ada/370  compiler.  You  should  have 
available  a  copy  of  IBM  Ada/370  Language  Reference  (SC09-1297)  or 
ANSI/MIL-STD-1815A.  the  Ada  LRM. 

If  you  need  help  getting  started  with  IBM  Ada/370.  see  Chapter  9.  IBM  Ada/370 
Tutorial. 


Compiling  a  Source  Program 

The  AOA  command  compiles  a  source  program.  The  following  sections  show 
you  how  to  use  this  command  under  VM/CMS.  MVS  TSO.  and  as  an  MVS  bat"*' 
job. 


Using  the  AOA  Command  under  VM/CMS 

— ADA- 


r -filejiame-j- 


ft  lejype- 


L-/tteji»de— I 


'—cornu  jm  1  tjtame- 


*— (-options- 


r~L 

— [-modtfters — l-)— 1 


TZT 


The  “?"  option  displays  syntax  information,  including  a  list  of  the  ADA  options,  on 
the  screen. 

Most  situations  require  that  you  pass  the  file  name  of  the  source  file.  The 
compilation  unit  name  is  required  when  you  use  the  Bind  option,  or  when  you 
use  the  Run  and  NOCOmpile  options.  The  filejype  and  mejnode  default  to  ADA 
and  '.  respectively. 

When  you  specify  a  compiler  option  in  ADA.  you  can  use  the  minimum  unique 
abbreviation.  For  example,  you  can  specify  CReate  as  CR. 

Many  compiler  options  are  matched  by  an  opposite.  For  example,  the  opposite 
of  the  MAP  option  is  the  NOMAP  option.  For  such  cases,  one  of  the  options  is 
designated  as  the  default.  For  an  option  that  takes  a  numerical  value,  a 
particular  value  may  be  assigned  as  the  default.  The  compiler  uses  default 
settings  unless  you  override  them  by  specifying  the  nondefault  options  to  ADA. 

Precede  the  list  of  options  by  a  blank  space  and  a  left  parenthesis,  and  separate 
them  from  each  other  by  blank  spaces.  A  closing  parenthesis  is  optional. 


C  Copynow  IBM  Corp.  1991 
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Some  of  the  options  have  modifiers,  which  you  must  enclose  in  parentheses 
Where  you  can  enter  multiple  modifiers  to  an  option,  such  as  with  the  Xref 
option,  separate  the  modifiers  with  a  comma. 

Here  are  some  examples: 

1  ADA  EXAMPLE 

Example  1  compiles  EXAMPLE  ADA  *  using  the  default  options. 

2.  ADA  EXAMPLE  (LIBRARY  (DEMO  LIBRARY)  OEBUG 

Example  2  compiles  EXAMPLE  ADA  *  with  the  LlBrary  and  Oebug  options 
LIBrary  causes  the  compiler  to  use  a  file  containing  an  alternative  library 
The  library  has  the  name  DEMO  LIBRARY  *. 

3.  ADA  EXAMPLE  (XREF  (BYUNIT, FULL) 

Example  3  compiles  EXAMPLE  ADA  *  with  the  Xref  option  to  produce  a 
cross-reference  listing.  The  listing  is  ordered  by  compilation  unit  and 
includes  cross-references  to  ail  visible  units. 


Using  the  ADA  Command  under  MVS  TSO 

a 

**— — EX  ‘qual t/ter. CLIST(AOA)'—' 


■u: 


-dsname- 


-qual  t/ter.dsnome- 


73 


f 

-{-options- 


r 

1 — {-modifiers— *-)- 


Under  MVS.  the  qualifier  at  Q  is  the  high-level  qualifier  assigned  to  IBM 
Ada/370  by  your  system  administrator.  In  examples  for  this  book,  we  use  the 
high-level  qualifier  ADA.  The  qualifier  at  Q  is  the  high-level  qualifier  for  the 
data  set  you  are  specifying.  By  default,  the  high-level  qualifier  is  set  by  the 
PROFILE  PREFIX  command.  This,  in  turn,  defaults  to  your  TSO  logon  identifier 

The  “?"  option  displays  syntax  information,  including  a  list  of  the  ADA  options,  on 
the  screen. 

Most  situations  require  that  you  pass  the  file  name  of  the  source  file.  The 
compilation  unit  name  is  required  when  you  use  the  Bind  option. 

When  you  specify  a  compiler  option  in  AOA.  you  can  use  the  minimum  unique 
abbreviation.  For  example,  you  can  specify  CReate  as  CR. 

Many  compiler  options  are  matched  by  an  opposite.  For  example,  the  opposite 
of  the  MAP  option  is  the  nomap  option.  For  such  cases,  one  of  the  options  is 
designated  as  the  default.  For  an  option  that  takes  a  numerical  value,  a 
particular  value  may  be  assigned  as  the  default.  The  compiler  uses  default 
settings  unless  you  override  them  by  specifying  the  nondefault  options  to  AOA. 
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Precede  the  list  of  options  by  a  blank  space  and  a  left  parenthesis,  and  separate 
them  from  each  other  by  blank  spaces.  A  closing  parenthesis  is  optional 

Some  of  the  options  have  modifiers,  which  you  must  encfose  in  parentheses 
Where  you  can  enter  multiple  modifiers  to  an  option,  such  as  with  the  Xref 
option,  separate  the  modifiers  with  a  comma. 

Here  are  some  examples 
1  EX  1 AOA.CLIST (AOA) '  'EXAMPLE' 

Example  1  compiles  EXAMPLE  using  the  default  options. 

2.  EX  'AOA.CLIST (ADA) 1  'EXAMPLE  (LIBRARY  ("DEMO. LIBRARY")  DEBUG' 

Example  2  compiles  EXAMPLE  with  the  LlBrary  and  Debug  options.  LIBrary 
causes  the  compiler  to  use  a  data  set  containing  an  alternative  library  The 
library  has  the  name  OEMO. LIBRARY  The  compiler  also  saves  information 
needed  by  the  IBM  Ada/370  debugger. 

3.  EX  'AOA.CLIST (ADA) '  " 'USER  1. EXAMPLE"  (XREF  (BYUNIT, FULL) ' 

Example  3  compiles  EXAMPLE  with  the  high-level  qualifier  USER1  It  includes 
the  Xref  option  to  produce  a  cross-reference  listing.  The  listing  is  organized 
by  compilation  unit  and  includes  cross-references  to  all  visible  units. 

Compiling  a  Program  with  Job  Control  Language  (JCL) 

This  section  describes  how  to  invoke  the  compiler  as  a  batch  job  under  MVS 
using  Job  Control  Language  (JCL).  Ft,r  information  on  how  to  invoke  the  binder 
using  JCL  see  "Invoking  the  Binder  with  Job  Control  Language  (JCL)"  on 
page  3-2. 

The  AOAC  cataloged  procedure  invokes  the  compiler  on  a  source  file. 


— - ■ — -  - \ 

//MYPBOG  JOB  ,MSGCLASS«0,MSGIEVEL*(M).N0TIFY*U$ER1, 

//  CLASS** 

//" 

//•  PURPOSE:  TO  RUN  THE  AOA  COMPILER 
//* 

//COMPILE  EXEC  PROC*AOAC.AOASRC*'USERI.AOA.SOURCE(HELLO),t 
//  USER-USER1.  CMPPRM*' CHECK' 

_ _ / 

Figure  2-1  Using  the  AOAC  Cataloged  Procedure  to  Invoke  the  Binder 

The  preceding  example  job.  MYPROG.  compiles  member  HELLO  in  the  source 
POS.  USER!  AOA  SOURCE.  The  user's  name.  USER1.  is  identified  with  the  USER 
variable.  This  variable  is  used  as  a  high-level  qualifier  to  construct  data-set 
names  for  the  compiler,  such  as  USER1.A0A.UBRARY.  which  is  the  default  library. 
Your  job  card  will  probably  be  different,  because  it  depends  on  your  site's 
conventions. 

After  you  execute  this  job.  the  Ada  program  contained  in  member  HELLO  is 
compiled  into  the  working  sublibrary  of  USER1.ADA.UBRARY. 

A  sample  of  AOAC  cataloged  procedure  appears  in  Figure  2-2  on  page  2-4  The 
exact  location  of  adac  may  depend  on  your  site's  conventions. 
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//AOAC 

PROC  CMPPRM-1  ' ,MEMSIZE-8196K, 

// 

STPLI8-1 A0A110.L0A0LIB' ,MAXTIME-6G, 

// 

V I 0-V l 0 , SYSDA-S Y5ALL0A , S YSOUT- 1 • ' 

//* 

//*  ERASE  AOA. INFO  DATASET 

//* 

// 

EXEC  PGM-IEFBR14 

//AOA INFO 

00  0SN-4USER. .AOA. INFO, DISP-(M0D, DELETE) , 

// 

SPACE” (1,1) ,UNIT-ASYS0A 

// . 

//* 

INVOKE  THE  COMPILER 

//* . 

//STEP1 

EXEC  PGM-EVGCOMP , PARM- 1 4CMPPRM 1 .REGI0N-4MEMSI2E, 

// 

T IME-4MAXT IME , 0YNAMNBR-05 

//STEPLIB 

00  0SN-4S  T  PL I B , D I SP-SHR 

//CONOUT 

00  SYSOUT-4SYSOUT,DCB-(LRECL-12O,BLKSIZE-120) 

//AOA IN 

00  0SN-4A0ASRC ,01 SP-SHR , FREE-END , DCB-BUFNO-4 

//AOALIB 

00  0SN-4USER.. AOA. LIBRARY, 0ISP-SHR 

//AOA INFO 

00  0SN-4USER..A0A. INFO,0ISP-(NEV,PASS,CATLG) , 

// 

0CB- (RECFM-VB, LRECL-5 12 , BLKS I ZE-3 120 .0S0RG-PS ) , 

// 

SPACE- ( 80 , ( 10 , 50) ) , UN I T-4S YSOA 

//ADALIST 

00  0SN-4USER. .LISTING, DISP-(M00,CATLG,CATLG) , 

II 

0CB- ( RECFM-V8A , LRECL-259 , BLKS I ZE-3 120 .0S0RG-P0 .BUFNO-2) , 

II 

SPACE- ( 1 32 , ( 500 , 2000 , 20) ) , UN 1 T-4SYSDA 

//A0AUT1 

00  SPACE-( 132, (500,2000)), 

// 

0CB- ( RECFH-F8 , LRECL- 136, BLKS IZE- 3400, 0S0RG-0A , BUFN0-2 ) , 

// 

UNIT-4SYS0A 

//A0AUT2 

00  SPACE-( 132, (500,2000)), 

// 

0CB- ( RECFM-VB , LRECL- 1 36 , BLKS I ZE- 3 120 , 0S0RG-PS .BUFNO-2 ) , 

II 

UNIT-4VI0 

//ADAUT3 

00  SPACE-(132, (500,2000)), 

II 

OC8-(RECFM-FB,LRECL-102B,BLKSIZE-2O56,DSORG-OA, BUFNO-2) , 

II 

UNIT-4SYS0A 

//A0AUT4 

00  SPACE- (132, (500, 2000)), 

// 

0CB- (RECFM-FB , LRECL- 1 32 , BLKS I ZE-2640 , 0S0RG-0A .BUFNO-2) , 

// 

UNIT-4SYS0A 

Figure  2-2.  AOAC  Cataloged  Procedure 


Symbolic  Variables  for  AOAC  Cataloged  Procedure 

The  AOAC  cataloged  procedure  includes  several  symbolic  JCL  substitution 

variables  you  can  modify  to  specify  the  various  options  available. 

Symbolic 

Variable  Description 

ADASRC  Specifies  the  data-set  name  (OSN)  Tor  the  Ada  source  file.  This 
name  must  be  set  in  order  to  successfully  compile  an  Ada 
program. 

CMPPRM  Specifies  options  to  the  compiler  in  the  FARM  field.  This  variable, 
found  in  Step  1  of  the  AOAC  cataloged  procedure,  specifies 
options  to  the  compiler  in  the  FARM  field.  These  options  are  the 
same  ones  used  when  you  invoke  the  compiler  with  the  AOA 
command. 


2-4  IBM  Ada/370 


Compiling  a  Source  Program 


MAXTIME 

MEMSIZE 

STPUB 

SYSDA 

SYSOUT 

USER 

VIO 


The  compiler  options  have  the  following  syntax: 


1 

-upciuns— 

i 

— (- modifiers — 

-)- 

Table  2-2  on  page  2-8  lists  the  valid  options,  their  modifiers,  and 
defaults. 

Sets  a  maximum  amount  of  time  for  the  compiler  job  step  to  run 
(via  the  TIME  parameter  on  a  JCL  EXEC  card).  The  default  value  is 
60  minutes,  but  this  value  can  be  changed  when  the  cataloged 
procedure  is  installed. 

Specifies  the  amount  of  memory  in  which  to  run  the  compiler  job 
step  (via  the  REGION  option  on  a  JCL  EXEC  card).  The  greater  the 
memory,  the  belter  the  performance  of  the  compiler  The  default 
value  is  8196Kb.  but  this  value  may  be  changed,  depending  on 
your  site  s  conventions. 

Indicates  the  data-set  name  of  the  partitioned  data  set  that 
contains  the  compiler  module.  EVGCOMP.  This  default  can  be 
changed  when  the  cataloged  procedure  is  installed. 

Specifies  the  UNIT  for  permanent  data  set  allocations.  The 
default  is  SYSALLDA,  but  this  value  can  be  changed  depending  on 
your  site's  conventions. 

Identifies  the  output  class  for  the  compiler  output.  The  default  is 
but  this  can  be  changed,  depending  on  your  site's 
conventions. 

Indicates  the  high-level  qualifier  that  is  required  to  build  data-set 
names  used  by  the  compiler  You  must  specify  this  variable.  It 
is  common  to  set  this  vanable  to  your  TSO  logon  identifier 

Specifies  the  UNIT  for  temporary  data  set  allocations.  The  default 
is  VIO.  but  the  default  can  be  changed  depending  on  your  site's 
conventions. 
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The  Compiler  Options 

The  ADA  command  invokes  the  IBM  Ada/370  compiler  Table  2-1  provides  a 
brief  summary  of  the  compiler  options.  The  square  brackets  enclose  optional 
modifiers.  You  do  not  actually  enter  the  brackets  as  part  of  the  command 
syntax.  For  the  specific  syntax  of  each  option,  see  the  option  descriptions  on  the 
pages  specified  in  the  table. 


Table  2-1  (Page  t  of  2). 

Compiler  Options 

Option 

Default 

Function 

Page 

Asm 

NOAsm 

Assembly  listing. 

2-9 

[NOGen 

Suppress  listing  of  expanded  generics. 

i  NOSys) 

Suppress  listing  of  system-supplied  generics. 

Bind 

Compile 

Bind  previously-compiled  main  unit. 

2-10 

CHeck 

COmpile 

Compile  with  syntactic  and  semantic  checking  only 

2-10 

[Nosemant icj 

Compile  with  syntactic  checking  only 

COmpile 

COmpi 1e 

Compile  code  for  a  library  unit. 

2-11 

CReate  {number_ol_untts\ 

NOCReate 

Initialize  working  subfibrary  for  the  compiler. 
number j>f_unita  is  number  of  compilation  units  in 
sublibrary. 

2-11 

Oebuq 

NOOebuq 

Output  information  for  debugging. 

2-13 

Error 

NOError 

Specify  action  to  be  taken  when  errors  occur  Must 
include  at  least  one  modifier. 

2-13 

(Count  -  number ] 

Abort  compilation  after  number  errors. 

lUst| 

Generate  interspersed  listing  of  errors  and  source 
code. 

Generate 

NOGenerate 

(VM/CMS) 

Generate  a  load  image. 

2-14 

NOGenerate 

Generate  (MVS) 

INI  i  $t  ( max_number | 

COmpile 

Compile  multiple  source  files  with  one  invocation  of 
the  compiler.  max_number  is  the  maximum  number 
of  compilation  failures  during  input  list  processing. 

2-15 

LlBrary  library _name 

Specify  Ada  library  name. 

2-15 

USt 

NOlISt 

Generate  interspersed  listing  of  errors  and  source 
code. 

2-16 

MAIn  [comp_unit_name) 

COmpile 

Compile  and  bind  code  for  a  main  unit. 

2-16 

MAP 

NOMAP 

Produce  linkage  map  during  binding.  Use  with  MAIn, 
Bind,  or  Run  options. 

2-17 

NOCOmpile 

COmpile 

Suppress  the  compiler. 

2-17 

Run 

NORun 

Execute  main  program. 

2-18 
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Table  2-1  (Page  2  of  2). 

Compiler  Options 

Option 

Default 

Function 

Page  j 

Suppress 

NOSuppress 

Suppress  selected  run-time  checks  or  line  information 
tables  in  generated  object  code.  Must  include  at 
least  one  modifier. 

2-18 

(lineinfo) 

Suppress  generation  of  line  information  tables. 

(Checks 

Suppress  all  run-time  checks. 

1  E  tab] 

Suppresses  only  elaboration  checks. 

Trace 

NOTrace 

Oispiay  diagnostic  messages  from  the  compiler. 

2-19 

Xref 

NO Xref 

Produce  a  cross-reference  listing. 

2-19 

(Byuni  t| 

Order  the  listing  by  compilation  unit. 

(Full! 

Cross-reference  all  visible  units. 
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Asm  Option 


Detailed  Descriptions  of  Compiler  Options 

The  following  detailed  descriptions  of  the  compiler  options  include  syntax 
diagrams.  In  these  diagrams,  uppercase  characters  indicate  the  minimum 
abbreviation  of  options  and  their  modifiers.  Options  and  modifiers  that  are 
underscored  are  the  defaults. 


Asm  Option 


NOGen 

NOSys 


The  Asm  option  produces  pseudo-assembly  language  for  the  object  code 
interspersed  with  the  Ada  source  for  each  compilation  unit.  It  causes  the 
creation  one  listing  for  each  source  file.  Asm  also  provides  information  on  the 
relative  offset  and  size  allocation  of  each  data  item  or  constant.  This  listing  is 
called  the  data  map  For  more  information  on  the  listing  produced  by  Asm.  see 
“Source  and  Assembly  Listings  '  on  page  7-1. 

If  you  use  the  Asm  option  at  the  same  time  you  invoke  the  IBM  Ada/370  binder, 
the  compiler  also  produces  a  binder  listing. 

The  NOGen  modifier  suppresses  the  listing  of  code  generated  for  expanded 
generics.  Otherwise,  listings  include  the  code  generated  for  all  expanded 
generics. 

The  NOSys  modifier  suppresses  the  listing  of  code  generated  for  system-supplied 
generics. 

Use  NOGen  or  NOSys  to  reduce  the  size  of  listings. 

Under  VMICMS 

The  name  of  the  listing  file  takes  the  form  source  LISTING  A.  where  source  is  the 
file  name  of  the  source  file. 

Under  MVS 

The  name  of  the  listing  data  set  takes  the  form  qualifier  uSTiNG{soi/reej  where 
qualifier  is  the  TSO  logon  identifier  and  source  can  be  either  the  name  of  the 
member  of  a  partitioned  data  set  (PDS)  used  as  source  or  the  second  qualifier  in 
the  name  of  a  sequential  data  set. 
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Check  Option 


Bind  Option 

►* - t-BInd - [ - - 

t-COffijlf - ' 

The  Bind  option  binds  a  main  program  that  has  been  previously  compiled  as  a 
library  unit.  As  output,  it  produces  an  object  file.  When  you  use  this  option, 
enter  the  compilation  unit  name  in  place  of  the  source  file  name.  You  can  only 
use  the  Bind  option  for  compilation  units  that  reside  in  the  working  sublibrary  of 
the  Ada  program  library. 

To  invoke  the  binder  when  you  compile  the  source  (rather  than  in  a  separate  call 
to  ADA),  use  the  MAIn  option. 

You  cannot  use  the  Bind  option  in  combination  with  MAIn.  CHeck.  INIist.  compile, 
or  NOCOmp i  le.  If  you  enter  more  than  one  of  these  options.  IBM  Ada/370  only 
accepts  the  last  one  in  the  command  line.  If  you  do  not  use  any  of  these 
options,  the  default  is  compile. 

Under  VMICMS 

The  object  file  created  by  compiling  with  the  Bind  option  has  the  file  type  TEXT 
Under  MVS 

The  object  file  is  a  POS  created  by  compiling  with  the  Bind  option  It  takes  the 
form  qualifier  OBJIcompjunit).  where  qualifier  is  your  TSO  logon  identifier  and 
compjjnit  is  the  compilation  unit  name. 

Check  Option 


c 


(-Noscaantlc 


The  CHeck  option  causes  the  compiler  to  perform  only  syntactic  and  semantic 
error  checking.  Because  no  object  code  is  produced,  you  can  save  compilation 
time  and  disk  space  during  error  checking.  If  you  include  the  Nosemantic 
modifier,  the  compiler  only  performs  syntactic  error  checking. 

You  cannot  use  the  CHeck  option  in  combination  with  MAIn.  Bind.  INIist.  compile, 
or  NOCOmpi  le.  If  you  enter  more  than  one  of  these  options.  IBM  Ada/370  only 
accepts  the  last  one  in  the  command  line.  If  you  do  not  use  any  of  these 
options,  the  default  is  COmpi  le. 


2*10  IBM  Ada/370 


Create  Option 


Compile  Option 


The  Compile  option  causes  all  compilation  units  in  the  source  file  to  be  library 
units,  rather  than  main  units. 

You  can  also  make  a  library  unit  into  a  main  unit  using  the  Bind  option. 

You  cannot  use  the  compile  option  in  combination  with  MAIn.  Bind.  CHeck.  INiist. 
or  NOCOmpi  le.  If  you  enter  more  than  one  of  these  options.  IBM  Ada/370  only 
accepts  the  last  one  in  the  command  line.  If  you  do  not  use  any  of  these 
options,  the  default  is  compile. 


Create  Option 


•CRaate* 


-  [  -number  of  _un  t  ts — )  — ^ 


L-NOCReatr 


CReate  initializes  the  working  sublibrary  for  the  compiler.  The  compiler  creates  a 
new  sublibrary,  deleting  the  previous  copy,  if  one  exists. 

The  number  ofjjmts  variable  specifies  the  number  of  compilation  units  the 
sublibrary  can  contain  The  default  is  200.  The  largest  number  of  units  a 
sublibrary  can  contain  is  4671. 

This  number  indicates  an  approximate  size  for  the  sublibrary.  The  number  of 
units  that  actually  fit  into  a  sublibrary  depends  upon  their  size  and  complexity. 
For  further  information  on  sublibraries,  see  Chapter  5.  Working  with  the  Ada 
Library  System 

When  you  use  CReate  in  conjunction  with  the  LIBrary  option,  it  initializes  the 
working  sublibrary  in  the  library  specified  by  LIBrary. 

You  cannot  use  CReate  in  combination  with  the  Bind  option. 

NOCReate  is  the  default.  With  NOCReate.  the  compiler  does  not  initialize  the 
working  sublibrary. 


Chapter  2.  Compiling  Ada  Programs  2*1 1 


OONAMES  Option  (MVS  JCL  Only) 


DDNAMES  Option  (MVS  JCL  Only) 


OONAMES —  ( -o  Id  jiant—n**  jiamt-* — ) - - 

OONAMES  specifies  the  Data  Description  (DD)  names  that  identify  the  data  sets 
used  by  the  compiler  and  binder.  OONAMES  always  requires  a  value. 

For  use  with  the  compiler,  o Idjiame  has  one  of  the  following  values: 

AOAIN 

AOAINFO 

ADAUB 

AOAUST 

ADAUT1 

AOAUT2 

ADAUT3 

ADAUT4 

For  use  with  the  binder.  old_name  has  one  of  the  following  values: 

AOAINFO 

AOALI8 

AOAUST 

AOAUT1 

AOAUT2 

AOAUT3 

A0AUT4 

Usually,  you  do  not  need  to  change  the  DD  names  associated  with  the  compiler 

This  example  of  a  JCL  code  fragment  uses  OONAMES  to  identify  a  new  00  name 
specifying  the  source  file  and  the  ada  library: 

//MYSTEP  EXEC  PGM«EVGCOMP , PARH" 1 OONAMES ( ADA I N-MYSOURCE , AOAL I B«M YL 1 0 ) ' 
//MYSOURCE  00  OSN-quol  t/ter. ADA. SOURCE ( PROGRAM 1) 

//MYUB  00  0SN«<juff  It/ter.  A0A .  LIBRARY 
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Debug  Option 


t+ - —Debug 

Lunn-h 


HOOebuq- 


The  Debug  option  causes  information  used  by  the  IBM  Ada/370  debugger  to  be 
placed  in  the  working  sublibrary.  When  used  with  the  MAIn  or  8ind  options.  Debug 
produces  a  debugging  map,  which  is  required  by  the  debugger. 


For  more  information  about  debugging,  see  Chapter  8.  The  IBM  Ada/370 
Debugger. 


With  NOOebug.  the  compiler  does  not  place  debugging  information  into  the  working 
sublibrary. 


Under  VMICMS 

The  debug  map  file  takes  the  name  comp_unit  DEBUGMAP  a  where  co mpjunit  is 
derived  from  the  name  of  the  compilation  unit. 


Under  MVS 

The  debug  map  file  takes  the  name  Qualifier  DEBUGMAP(comp  unif).  where 
qualifier  is  the  high-level  qualifier  and  compjjnit  is  derived  from  the  name  of  the 
compilation  unit. 


Error  Option 


r 

-r— Error - ( -7-Count  *numbei — (— )  - 

I  Liist- 

HtOE 


DError- 


Error  controls  the  way  the  compiler  behaves  when  it  finds  errors  in  the  source 
file.  You  must  choose  at  least  one  of  the  modifiers. 

The  Count  modifier  specifies  the  number  of  errors  that  cause  the  compiler  to  stop 
processing.  The  compiler  includes  syntax,  semantic,  and  warning  errors  in  the 
count.  For  example.  C0UNT«5  causes  the  compiler  to  stop  processing  after  it  finds 
five  errors.  If  you  omit  the  Count  modifier,  the  compiler  stops  processing  when  it 
finds  32767  errors,  the  default  error  limit. 

The  List  modifier  creates  a  file  containing  compile-time  error  messages 
interspersed  with  the  source  code.  If  there  are  no  errors,  the  compiler  does  not 
generate  the  listing.  To  generate  this  listing  regardless,  use  the  List  option. 

See  "List  Option '  on  page  2-16. 

With  NOError,  the  compiler  does  not  modify  its  behavior  when  it  finds  errors 
during  processing. 

Under  VMICMS 

The  listing  file  created  by  the  List  modifier  is  called  source  LISTING  A.  where 
source  is  the  file  name  of  the  source  file. 
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Under  MVS 

The  listing  file  created  by  the  List  modifier  is  called  Qualifier  uSTlNGfsource). 
where  qualifier  is  the  TSO  logon  identifier  and  source  is  the  file  name  of  the 
source  data  set. 


Generate  Option 

The  Generate  option  generates  a  load  image. 
Under  VMtCMS 


Generate- 
erat 


-i  genii  * 

HMSbb 


Under  VM/CMS,  when  you  compile  with  the  Generate  option,  the  ADA  command 
also  invokes  the  binder,  producing  an  object  file.  The  compiler  then  uses  the 
object  file  to  produce  the  load  module.  This  option  assumes  that  the  source  file 
contains  a  main  program.  The  load  module  created  by  the  Generate  option  has 
the  name  compjunit  MODULE  A.  where  compjunit  is  derived  from  the 
compilation  unit  name. 

With  NOGenerate.  the  compiler  does  not  generate  an  executable  load  module. 
Under  MVS 


The  NOGenerate  option  suppresses  the  invocation  of  the  linkage  editor  after 
binding  a  main  program.  Use  this  option  when  you  want  to  invoke  the  linkage 
editor  with  options  that  differ  from  the  default.  For  example,  you  would  use 
NOGenerate  when  you  want  to  fink  the  main  program  with  non-Ada  object  code. 

The  load  module  created  by  the  Generate  option  has  the  name 
qualifler.LOAOtcompjunit),  where  compjunit  is  derived  from  the  name  of  the 
compilation  unit. 

The  NOGenerate  option  has  no  effect  when  used  in  combination  with  NOCOmpile.  or 
when  you  compile  the  program  as  a  library  unit  instead  of  a  main  unit. 

You  cannot  use  NOGenerate  in  combination  with  the  Run  option. 
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Inlist  Option 


l_ 


{-max  jtumber- 


The  INI  i st  option  compiles  multiple  source  files  with  a  single  invocation  of  the 
compiler.  When  you  use  this  option,  enter  the  name  of  the  file  containing  the 
input  list  in  place  of  the  source  Hie  name.  For  more  information  on  the  use  of 
input  lists,  see  “Compiling  Multiple  Source  Files"  on  page  2-20. 

If  a  source  file  fails  to  compile,  the  compiler  continues  to  process  the  remaining 
files.  You  can  specify  that  the  compiler  stops  processing  after  a  certain  number 
of  source  files  fail  to  compile.  To  do  so.  use  the  maxjiumber  variable. 

You  cannot  use  INUst  in  combination  with  the  Bind.  CHeck,  MAIn.  Compile  or 
NOCOmpi  le  options.  If  you  enter  more  than  one  of  these  options.  IBM  Ada/370 
only  accepts  the  last  one  in  the  command  line  If  you  do  not  use  any  of  these 
options,  the  default  is  COmoiie 


Library  Option 


►* LIBrary - ( — l  lbrary_name — ) - - 

The  LIBrary  option  specifies  the  name  of  the  Ada  library  file  to  be  used  by  the 
compiler.  The  library _name  modifier  is  the  name  of  a  library  file  that  contains 
the  names  of  one  or  more  sublibraries. 

When  you  do  not  specify  the  LIBrary  option,  the  compiler  uses  the  default  library 
file.  Under  VM/CMS.  it  has  the  name  ADA  LIBRARY  *.  Under  MVS,  it  has  the 
name  Qualifier  ADA  LIBRARY,  where  qualifier  is  the  TSO  logon  identifier.  For 
information  concerning  libraries  and  sublibraries,  see  Chapter  5.  Working  with 
the  Ada  Library  System 

Under  VMICMS 

You  can  provide  the  library  jiame  variable  in  either  of  two  formats.  The 
preferred  is  filename  filejype  filejnode.  The  other  format  is 
file_modefile  jiame. file  Jy pa.  In  both  formats,  if  you  specify  only  the  file  name. 
filejype  defaults  to  library  and  file  mode  defaufts  to  If  you  do  not  specify 
a  library  file.  ADA  searches  for  ADA  LIBRARY  * 

For  example,  to  specify  library  PROJf  LIBRARY  A,  when  you  compile  the  file 
MYPROG,  enter: 

AOA  MYPROG  (LIB(PROJl) ) 

It  is  recommended  that  you  do  not  select  an  alternative  file  type  for  the  Ada 
library  file.  Retaining  the  default  file  type  maintains  consistent  file  naming 
conventions  for  all  users 
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Under  MVS 

A  library  can  be  either  a  sequential  data  set  or  a  member  of  a  PDS.  The 
library  _name  variable  can  be  any  valid  data-set  name  format.  For  example,  to 
specify" library  PROJt. LIBRARY  on  USER1  when  you  compile  the  data  set 
M YPROG . SOU RC E  enter: 

EX  'AOA.CLIST(AOA) '  ' ' ' USER l.MYPROG. SOURCE' *  (LIB(*  *0SER1 . PROJ 1 . LIBRARY •  • }  • 


List  Option 


List — 
mist- 


The  List  option  creates  a  file  containing  a  listing  for  each  source  file.  The  listing 
contains  compile-time  messages  interspersed  with  the  source  code.  If  there  are 
multiple  compilation  units  in  a  source  file.  List  places  the  listings  for  all  units 
into  a  single  file. 


Under  VMICMS 

The  compilation  listing  file  takes  the  form  source  LISTING  A.  where  source  is  the 
file  name  of  the  source  file. 


Under  MVS 

The  compilation  listing  file  takes  the  form  quallfter.LlSTlNG(source) ,  where 
qualifier  is  the  tso  logon  identifier  and  source  can  be  either  the  name  of  the 
member  of  a  PDS  used  as  the  source  or  the  second  qualifier  in  the  name  of  a 
sequential  data  set. 


Main  Option 


**  |  MAIn- 

*— COest 


n 


( — conpjtnttjiom — ) 


zr 


The  ha  In  option  causes  the  compiler  to  produce  code  for  the  source  file  as  an 
Ada  main  program.  The  MAIn  option  compiles  a  program  and  performs  the 
binding  operation  without  the  need  to  specify  any  other  option. 

If  the  Ada  source  file  contains  one  or  more  library  compilation  units  in  addition 
to  the  main  compilation  unit,  enter  the  name  of  the  main  program  in  the 
comp_unit_name  variable. 

You  cannot  use  the  MAIn  option  in  combination  with  Bind,  CHeck,  INI  1st.  compile, 
or  NOCOmpile,  If  you  enter  more  than  one  of  these  options.  IBM  Ada/370  only 
accepts  the  last  one  in  the  command  'me  If  you  do  not  use  any  of  these 
options,  the  default  is  compile. 

Under  VMICMS 

The  object  file  created  by  compiling  with  the  MAIn  option  takes  the  form 
compjjnit  TEXT  A.  where  c ompjunit  is  the  compilation  unit  name. 

Under  MVS 

The  object  file  created  by  compiling  with  the  MAIn  option  takes  the  form 
qualifier. OBJ(compjunit),  where  qualifier  is  the  TSO  logon  identifier  and 
comp_unit  is  the  compilation  unit  name. 
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The  MAP  option  causes  the  compiler  to  produce  a  linkage  map  when  the  IBM 
Ada/370  binder  processes  a  mam  program. 

Use  MAP  in  combination  with  either  MAln  or  Bind,  both  of  which  invoke  the  binder. 
You  can  also  use  MAP  in  combination  with  Run  as  long  as  you  do  not  use  the 
NOCOmp it e  option. 

With  NOMAP.  the  compiler  does  not  create  a  linkage  map  when  the  IBM  Ada/370 
binder  processes  a  main  program. 

Under  VMICMS 

The  map  file  is  called  object  AOAMAP  A.  where  object  is  the  file  name  of  the 
object  file 

Under  MVS 

The  map  file  is  called  Qualifier  AOAMAP(comp_unif).  where  qualifier  is  the  TSO 
logon  identifier  and  compjjnit  is  the  name  of  the  main  compilation  unit. 


Nocompile  Option 


The  NOCOmpi le  option  causes  the  ADA  command  to  suppres?  the  compilation  step. 
Thus,  you  can  use  NOCOmpi  le  with  Run  to  run  an  Ada  program  that  has  already 
been  compiled.  When  you  use  NOCOmpi  le  with  Run.  enter  the  compilation  unit 
name  in  place  of  the  source  file  name. 


You  can  also  use  NOCOmpi  le  with  the  CReate  to  create  a  new  working  sublibrary 
without  having  to  compile  the  source  code. 


You  cannot  use  the  NOCOmpile  option  in  combination  with  MAln.  Bind.  CHeck,  INtist. 
or  compile.  If  you  enter  more  than  one  of  these  options,  IBM  Ada/370  only 
accepts  the  last  one  in  the  command  line.  If  you  do  not  use  any  of  these 
options,  the  default  is  Compile. 
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Run  Option 


The  Run  option  loads  and  executes  a  main  program.  The  compiler  assumes  that 
the  program  is  a  main  unit.  You  can  either  compile  and  run  a  program,  or  run  a 
precompiled  program.  To  run  a  previously  compiled  and  bound  program,  use 
Run  in  combination  with  the  NOCOmpiie  option.  When  you  use  Run  with  NOCOmpiie. 
you  must  specify  the  compilation  unit  name,  rather  than  the  Ada  source  file 
name. 

With  NORun.  the  compiler  does  not  execute  the  program. 


Suppress  Option 


n 

-Suppress — (— i - Llnetnfo- 

*— r-Checks- 
Lri 


-Eleb- 


L- WOSunoress- 


The  Suppress  option  suppresses  selected  runtime  checks  and  line  information  in 
generated  object  code,  resulting  in  smaller,  faster  modules.  You  must  choose  at 
least  one  of  the  modifiers.  Use  of  either  the  Suppress  option  or  pragma  Suppress 
causes  the  compiler  to  suppress  run-time  checks.  For  more  information  on 
pragma  Suppress,  see  the  chapter  on  tuning  in  the  IBM  Ada/370  Programmer's 
Guide. 

The  lineinfo  modifier  suppresses  the  generation  of  line  information  tables,  thus 
saving  the  space  required  to  produce  them.  These  tables  display  the  Ada 
source  line  number  when  an  unhandled  exception  occurs.  If  you  compile  your 
code  with  this  option  and  an  unhandled  exception  occurs  during  run  time,  the 
error  information  does  not  include  a  line  number. 

The  Checks  modifier  suppresses  all  run-time  checks. 

The  Elab  modifier  only  suppresses  elaboration  checks  made  by  other  units  on 
this  unit.  This  differs  from  the  way  pragma  Suppress  works.  The  pragma 
suppresses  elaboration  checks  made  on  other  units  from  the  unit  in  which  it 
resides. 

If  you  choose  both  the  Checks  and  Elab  modifiers,  the  Checks  modifier  takes 
precedence. 

With  NOSuppress.  the  compiler  does  not  suppress  selected  run-time  checks  and 
line  information  in  generated  object  code. 
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Trace  Option 


Trace- 


—l  1  I  O' 

L-not 


race- 


The  Trace  option  displays  diagnostic  messages  from  the  compiler.  This  option  is 
intended  for  use  in  submitting  problems  to  IBM.  For  more  information,  see  the 
IBM  Ada! 370  Diagnosis  Guide. 


Xref  Option 


•Xref 


*— ftOXref 


The  Xref  modifier  produces  a  cross-reference  listing  for  each  compilation  unit 
contained  in  the  source  file.  It  creates  one  listing  file  for  each  source  file 

Syunit  causes  Xref  to  display  symbols  by  compilation  unit.  By  default,  the  Xref 
listing  displays  symbols  in  alphabetic  order. 

Full  causes  Xref  to  cross-reference  each  compilation  unit  with  all  unit 
specifications  that  are  visible  to  it.  A  unit  specification  is  visible  if  it  is  an  import 
to  the  compilation  unit.  If  the  compilation  unit  is  a  body,  its  parent  and  its 
parent's  imports  are  also  visible.  Full  does  not  display  cross  references  for  the 
private  parts  of  imported  units.  By  default.  Xref  only  cross-references  the 
compilation  units  specified  in  the  command.  For  more  information,  see 
"Cross-Referencer '  on  page  7-2. 

VMICMS  Usage 

The  listing  file  takes  the  form  source  UST1NG  A.  where  source  is  the  file  name  of 
the  source  file. 

MVS  Usage 

The  listing  file  takes  the  form  qualifier. \jS7WG(source),  where  qualifier  is  the  TSO 
logon  identifier  and  source  can  be  either  the  name  of  the  member  of  a 
partitioned  data  set  (PDS)  used  as  source  or  the  second  qualifier  in  the  name  of 
a  sequential  data  set. 
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Compiling  Multiple  Source  Files 

An  input  list  is  a  file  containing  a  list  of  the  names  of  files  to  be  compiled.  Using 
input  lists,  you  can  compile  multiple  source  files  with  a  single  invocation  of  the 
compiler  This  reduces  the  time  it  takes  to  compile  a  group  of  source  files 
because  it  eliminates  some  redundant  activities  within  the  compiler 

The  names  of  source  files  appear  in  the  input  list,  along  with  other  information 
that  controls  the  compilation  process.  The  compiler  processes  items  in  the  input 
list  in  sequential  order.  Besides  the  object  code  that  is  the  usual  result  of 
compilation,  the  compiler  produces  a  file  that  contains  information  on  the  results 
of  the  success  or  failure  of  each  compilation. 

If  you  use  a  compiler  option  that  produces  compilation  listings  (Asm.  List.  Error, 
or  Xref.  the  compiler  produces  a  separate  listing  for  each  compilation  unit. 

To  compile  multiple  files  with  the  AOA  command,  use  the  iNlist  option 

If  the  compiler  detects  errors  during  compilation  of  any  source  file  in  the  list,  it 
goes  on  to  the  next  source  file.  There  may  be  cases,  especially  with  a  large 
input  list,  where  it  is  not  advisable  to  continue  through  the  entire  input  list  when 
multiple  source  files  abort.  The  INlist  option  has  a  variable  that  allows  you  to 
specify  the  maximum  number  of  source  file  compilation  failures  to  allow.  The 
next  failure  causes  the  compiler  to  stop  processing  the  input  list. 

Undmr  VMICMS 
The  command  string 

AOA  MYUST  (IN(6) 

compiles  the  source  fiies  in  the  input  list  MYUST  INUST.  setting  the  failure  limit  at 
six. 

Under  MVS 

The  command  string 

EX  'AOA.CLIST(AOA)'  'MYUST.  INLIST  (IN(6)* 

compiles  the  source  files  in  the  input  list  MYUST.INUST.  setting  the  failure  limit  at 
six.  The  compiler  uses  the  default  high-level  qualifier. 

Constructing  the  Input  List 

An  input  list  contains  two  types  of  information,  names  of  source  files  to  be 
compiled  and  compile-time  opt'ons. 

The  syntax  for  each  line  of  the  input  list  is: 

- - r-fl  Itjtamt - - - 

-compile-ttmejspti  on- 
— *  c  onmen  t 

-blank  Jl  Ine - - 

The  rules  for  creating  the  input  list  are: 

•  Place  only  pul  one  file  name  or  compile-time  option  on  a  line. 

•  Do  not  place  comments  on  the  same  line  with  other  information. 

•  If  the  first  nonblank  character  in  a  line  is  that  line  is  a  comment  line. 
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•  The  compiler  ignores  blank  lines. 

•  File  names  do  not  have  to  start  in  the  first  column. 

This  VM/CMS  file  list  follows  the  rules  correctly. 

*  YES,  THIS  IS  A  COMMENT 

AFILE  ADA  A 
8FILE  AOA  A 

BISUB  AOA  A 
82SUB  ADA  A 

CFILE  AOA  A 

If  an  error  occurs  during  input  list  processing,  the  compiler  updates  the  working 
sublibrary  with  information  about  the  units  that  have  been  compiled  successfully 
Also,  the  compiler  places  information  about  the  results  in  an  output  file  For 
more  information  about  the  contents  of  this  file,  see  “Getting  Information  on  an 
Input  List  Compilation  '  on  page  2-22. 

VMICMS  Source  File  Names 

Enter  the  names  of  source  files  into  the  input  list.  If  you  leave  out  the  file  type, 
the  compiler  assumes  the  file  type  is  AOA. 

Inpul  Ust  Compiler  Interpretation 

MYFILE  MYFILE  ADA  • 

MYFILE  TEST  MYFILE  TEST  * 

MYFILE  TEST  A  MYFILE  TEST  A 

MVS  Source  Dete  Set  Mamma 

Enter  the  names  of  source  data  sets  into  the  input  list  either  fully  or  partially 
qualified.  Enclose  fully  qualified  names  inside  a  pair  of  single  quotation  marks. 

If  you  leave  out  the  high-level  qualifier,  the  compiler  assumes  the  current  TSO 
logon  identifier. 

Input  Ust  Compiler  Interpretation 

MYFILE  'qualifier  MYFILE' 

MYFILE.TEST  'qualifier  MYFILE.  TEST’ 

'OTHER. MYFILE. TEST '  'OTHER. MYFILE. TEST ’ 

Embedding  Compile-Time  Options  in  the  Input  Ust 

You  can  place  compile-time  options  and  input  list  options  within  the  input  list. 
Options  set  when  you  invoke  the  compiler  apply  to  each  source  file  until  they  are 
overridden  by  an  option  embedded  in  the  input  list.  Options  that  appear  in  the 
input  list  apply  to  all  following  source  files  until  they  are  overridden  by  other 
embedded  options.  A  specific  option  can  appear  multiple  times  in  an  input  list. 


*•— -MPTIOHS - r-compt  lerjoptton - i - •-* 

'-inputJistjjptton-* 
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The  compiler  options  you  can  embed  in  input  lists  are: 

ASM 

CHECK 

COMPILE 

DEBUG 

ERROR 

INLIST 

LIST 

SUPPRESS 

XREF 


There  is  one  valid  inputjistjoption.  OEFault.  The  OEFault  option  causes  the 
compiler  to  reset  all  options  to  their  states  as  set  by  the  ADA  command.  OEFault. 
is  only  valid  as  part  of  the  &OHTIONS  command  in  an  input  list. 


The  following  example  shows  an  input  list  with  embedded  options,  along  with 
descriptions  of  how  the  options  change.  This  example  uses  VM/CMS  file  naming 
conventions:  MVS  users  should  use  MVS  conventions. 


Input  List 


How  Options  Change 


AFILE  AQA  A 
MPT  IONS  DEBUG 
BFILE  ADA  A 
MPT  IONS  NOOEBUG 
CFILE  ADA  A 
MPT  IONS  OEFAULT 
EFILE  ADA  A 
MPT  IONS  OEBUG 
PFILE  AOA  A 


Command-line  options 
Command-line  options  plus  Debug 
Command-line  options  plus  NOOebug 
Command-line  options  only 
Command-line  options  plus  Debug 


Getting  Information  on  an  Input  List  Compilation 

The  compiler  creates  a  file  and  places  information  about  of  the  compilation  into 
it.  Each  line  in  the  input  list  also  appears  in  this  file.  Following  each  line  from 
the  input  list  containing  the  name  of  a  source  file  is  a  line  that  shows 
compilation  status  for  the  file.  Source  files  that  compile  successfully  show  a 
return  code  of  zero  for  each  compilation  unit  in  the  file.  Files  that  do  not  compile 
show  the  return  code  of  the  error  that  caused  the  failure.  There  are  also 
descriptive  messages  where  return  codes  do  not  provide  enough  information. 


The  return  codes  that  can  appear  are: 

Code  Explanation 

0  Execution  complete.  No  errors  occurred. 

4  Execution  complete.  Warnings  were  issued,  but  no  errors  occurred. 

8  Source  code  errors,  such  as  syntactic  or  semantic  errors,  were  detected. 
Look  for  specific  errors  in  the  console  listing. 


Below  is  a  brief  example  of  an  input  list  and  the  OUTPUT  file  that  might  result. 
This  example  uses  VM/CMS  file  naming  conventions:  under  MVS  the  output 
follows  MVS  conventions. 
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Sample  Input  List  MYLIST  INPUT  A 

IOPTIONS  ASM 
FI LEONE  AOA  A 
IOPTIONS  OEF 
FILETWO  AOA  A 
iOPTIONS  BLTZ 

Sample  OUTPUT  File 

INPUT  LIST  processing  MYtlST  INPUT  A  -  yyyy-mm-dd  hh:m:ss  -  options  (options 

iOPTIONS  ASM 

FILEONE  ADA  A 

RC-00  FILEONE  AOA  A1 

iOPTIONS  OEF 

FILETWO  AOA  A 

RC-00  FILETWO  AOA  A1 

iOPTIONS  8LTZ 

»*  ERROR  IN  INPUT  LIST  COMMAND  SYNTAX 

VMICMS  File  Name 

The  name  of  the  OUTPUT  file  takes  the  form  input  Jist_name  OUTPUT  a.  where 
input Jistjiame  is  the  file  name  of  the  input  list. 

MVS  Data  Sat  Name 

The  name  of  the  OUTPUT  data  set  takes  the  form 

qualifier  OUTPUT(inputJist^name).  where  qualifier  is  the  current  TSO  logon 
identifier  and  input  Jistjiame  is  the  name  of  the  input  list. 


Generating  Recompilation  Scripts 

VMICMS  Syntax 

*+—ADARECOn—comp_umt_name - - — ■ — — — — ► 


•(-[-library — (-1  tbraryjiome-)- 

*-B« 


lady- 


MVS  Syntax 

*+-€X  ’  qua  l  if  ter.  CLIST  (AOARECOM)  ’ — 1  -coapjinitjiame—  —  — •  —» 


The  AOARECOM  command  generates  a  recompilation  order  list.  When  a  library 
consists  of  many  compilation  units  that  depend  on  (possibly  multiple  levels  of) 
with  statements,  it  can  be  difficult  to  determine  the  proper  compilation  order  if 


1 — (-j-Ubrary—  (-1  tbroryjiome-)- 


-Body- 
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the  specification  of  a  unit  needs  to  be  recompiled.  To  use  AOARECOM.  you  must 
have  compiled  the  compilation  units  into  a  specified  library  at  least  once. 
AOARECOM  reads  the  library  to  build  a  recompilation  list  of  the  units  that  depend 
upon  the  specified  unit.  This  list  contains  the  source  file  names  of  the  units  that 
need  to  be  recompiled.  Therefore,  if  you  move  an  Ada  compilation  unit  to  a  new 
source  file,  you  must  modify  the  recompilation  list. 

For  AOARECOM  to  correctly  generate  the  recompilation  list,  the  association 
between  file  names  and  compilation  units  cannot  change  between  the  time  they 
are  compiled  and  the  AOARECOM  invocation. 

The  file  list  produced  under  either  VM/CMS  or  MVS  is  suitable  for  input  to  the 
INI  1st  option  to  the  ADA  command.  For  more  on  this  subject,  see  “Compiling 
Multiple  Source  Files"  on  page  2*20. 

Do  not  change  the  names  of  the  source  file,  separate  the  specification  and  body 
into  different  files,  or  perform  any  other  change  that  alters  the  relationship 
between  that  file  and  the  compilation  unit  or  units  it  contains  between  the  time 
you  make  the  recompilation  list  and  the  time  you  perform  the  recompilation. 

You  can  to  edit  the  recompilation  list  after  running  AOARECOM.  to  make  changes 
to  the  recompilation  order  list. 

Also.  AOARECOM  produces  a  correct  source  file  list  only  if  each  file  contains  a 
single  compilation  unit. 

Precede  the  options  by  a  blank  space  and  a  left  parenthesis,  and  separate  them 
from  each  other  by  blank  spaces.  A  closing  parenthesis  is  optional. 

The  LIBrary  option  allows  you  to  specify  the  name  of  the  library  file. 
library  _name.  that  AOARECOM  is  to  read. 

If  you  specify  the  BOOy  option.  AOARECOM  assumes  that  compjjnitjiame  refers 
to  the  body  of  a  compilation  unit.  By  default,  compjunitjiame  refers  to  the 
specification  of  a  compilation  unit. 

Under  VMICMS 

You  can  provide  the  library _nama  variable  in  either  of  two  formats.  The 
preferred  format  is  flla_name  fllejype  niejnode.  The  other  format  is 
rile  jnode.filejiama  file _type.  In  both  formats,  if  you  specify  only  the  file  name. 
file  Jy pa  defaults  to  library  and  file  mode  defaults  to  "**  If  you  do  not  specify 
a  library  file,  ADA  searches  for  AOA  LIBRARY  ‘ 

The  recompilation  list  goes  into  a  file  called  c ompjjnit  INUST  A. 

The  command 

AOARECOM  MYJ>R0G  (L(MYLIB. LIBRARY)) 

generates  a  recompilation  list  that  includes  all  units  within  MYUB  LIBRARY  that 
must  be  recompiled  if  you  recompile  MY^PROG.  also  found  in  that  library. 

Under  MVS 

If  you  do  not  specify  libjtame.  the  default  is  qualifier. ada.library. 
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The  recompilation  list  goes  into  a  file  called  qualifierAHUST{compjjnit),  where 
qualifier  is  your  TSO  logon  identifier. 


Separate  Compilation  of  Generics 


The  command 

£X  'AOA.CLIST(AOARECOM) '  'MYJ>R0G  (l(MYLIB))' 

generates  a  recompilation  list  that  includes  all  units  within  qualifier  MYUB  that 
must  be  recompiled  if  you  recompile  MY_PROG.  also  found  in  that  library 


Separate  Compilation  of  Generics 

IBM  Ada/370  supports  separately-compiled  generics.  You  can  compile  a  generic 
specification  in  in  file  and  its  generic  body  in  a  separate  file. 

If  you  plan  to  compile  your  generics  separately,  compile  the  generic  body  before 
you  attempt  to  instantiate  the  generic.  The  generic  body  must  be  compiled  and 
visible  in  the  library  before  the  instantiation  can  occur 

You  can  compile  instantiations  before  you  compile  the  generic  body.  If  you  do. 
the  compiler  issues  a  warning.  When  you  compile  a  generic  body,  all 
instantiations  of  the  generic  become  obsolete.  You  must  recompile  all 
instantiations  of  the  generic  after  you  compile  a  new  generic  body 

For  more  information  on  the  compiling  and  instantiation  of  generic  units,  see 
Chapter  12  of  the  LRM. 
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Chapter  3.  Binding  and  Linking  an  Ada  Program 

The  purpose  of  this  chapter  is  to  show  you  the  different  ways  to  invoke  the  IBM 
Ada/370  binder  or  the  linkage  editor,  and  to  explain  when  you  need  to  use  them 

The  flexibility  in  symbol  naming  allowed  by  Ada  makes  implementation  of  the 
language  difficult  in  environments  using  pre-existing  linkage  editors  and  loaders 
To  alleviate  this  problem.  IBM  provides  a  special  Ada  linker  called  the  IBM 
Ada/370  binder.  It  combines  object  modules  produced  by  the  IBM  Ada/370 
compiler  and  outputs  them  as  a  standard  IBM  object  module. 

This  partially-linked  object  module  is  further  processed  by  the  system 
linker/loader  to  produce  an  executable  load  module.  The  IBM  Ada/370  binder 
provides  full  support  of  Ada  requirements  for  symbol  naming.  It  also  drastically 
reduces  the  number  of  external  definitions  and  references  that  must  be 
processed  by  the  host  system  linker. 

An  Ada  program  can  use  pragma  Interface  to  call  subprograms  written  in  a 
programming  language  other  than  Ada.  The  system  linker  puts  the 
standard-format  object  modules  produced  for  these  subprograms  into  the 
executable  load  module  it  creates  for  an  Ada  program. 

The  IBM  Ada/370  binder  also  includes  run-time  environment  routines  as  part  of 
its  output. 


Using  the  IBM  Ada/370  Binder 

To  Invoke  the  IBM  Ada/370  binder,  compile  an  Ada  main  program  using  the  MAln 
option  of  the  ADA  command.  The  system  invokes  the  binder.  The  binder  can 
produce  a  link  map  describing  the  contents  of  the  partially  linked  object  module 
it  generates.  The  link  map  provides  you  with  detailed  information  about  the 
run-time  memory  locations  of  the  vanous  pieces  of  code  that  make  up  your 
program. 

Another  option  to  the  ADA  command.  Bind,  causes  IBM  Ada/370  to  bypass  the 
compilation  step.  This  allows  you  to  bind  a  compilation  unit  that  you  have 
previously  compiled  as  a  library  unit  as  a  main  program. 

The  Generate  option  of  the  ADA  command  takes  binder  output  and  uses  system 
utilities  to  generate  a  load  module. 

For  more  information  on  the  MAln,  Bind,  and  Generate  options  to  the  ADA 
command,  see  “The  Compiler  Options"  on  page  2-6. 

You  must  rebind  your  main  program  when  you  recompile  any  Ada  compilation 
units  used  in  the  program.  You  do  not  have  to  rebind  the  program  if  you 
recompile  non-Ada  routines  that  your  Ada  program  calls,  but  you  still  have  to 
link  the  program  again  with  the  linkage  editor  or  loader. 


<0  Coeyrignt  IBM  Carp.  1991 
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Invoking  the  Binder  with  Job  Control  Language  (JCL) 

This  section  describes  how  to  invoke  the  binder  as  a  batch  job  under  MVS  using 
Job  Control  Language  (JCL).  For  information  on  how  to  invoke  the  compiler 
using  JCL  see  ‘Compiling  a  Program  with  Job  Control  Language  (JCL)“  on 
page  2-3. 

The  AOAB  cataloged  procedure  invokes  the  IBM  Ada/370  binder  to  bind  an  Ada 
main  program  that  has  been  complied  using  the  IBM  Ada/370  compiler  The 
output  of  the  binder  is  an  System/370  relocatable  object  data  set.  You  can 
submit  this  data  set  to  the  linkage  editor  to  generate  an  executable  load  module. 


//MYPROG  JOB  .•  ' .MSGCLASS  »0 , MSGLEVEL* ( 1 , 1 ) ,N0T I PY *U$ER1 , 

//  CLASS** 

//* 

//*  PURPOSE:  TO  RUN  THE  *0A  BINDER  ' 

//* 

//BIND  EXEC  PR0C*A0A8.UNIT«HEIL0. 

//  USER*USER1 

V _ -  > 

Figure  3-1  Using  the  AOAB  Cataloged  Procedure  to  Invoke  the  Binder 

The  preceding  example  shows  a  job,  called  MYPROG.  which  binds  the  Ada  main 
compilation  unit  HELLO  The  user  identifier  USER)  is  specified  with  the  USER 
variable.  This  variable  is  used  as  a  high-level  qualifier  to  construct  data-set 
names  for  the  compiler,  such  as  USER  1  ADA. LIBRARY.  This  library  is  the  default 
Ada  library.  Your  job  card  will  probably  be  different,  because  it  depends  on  your 
site's  conventions. 


As  this  job  executes,  the  compiler  creates  relocatable  object  code  in 
USER!  OBJ(HELLO).  This  object  code  was  generated  for  the  Ada  main 
compilation  unit  called  HELLO. 
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A  sample  of  the  adab  cataloged  procedure  appears  in  Figure  3-2.  The  exact 
location  of  ADAB  may  depend  on  your  site's  conventions. 


//AO AS 

PROC  8N0PRM-1  *,MEMSIZE-8196K, 

// 

STPLIB- ’ ADA1 19. LOADLIB ' .MAXTIME-60 , 

// 

VIO-VIO , $ YSOA-SYSALLDA, SYSOUT- ' •'.UNIT-'  ■ 

//**“*“* 

//* 

INVOKE  THE  BINDER 

//STEP1 

EXEC  PGM-EVGB I NO , PARM- 1 (UNIT .  (  &BN0PRM' .REGION-SMEHSIZE, 

// 

T INE-SHAXT IME .DYNAMNBR-65 , COND- (4 , LT) 

//STEPLIB 

OD  0SN-iSTPLI8,0ISP-SHR 

//CONOUT 

00  SYSOUT-4SYSOUT,OC8-(LRECL-129,BLKSIZE-120) 

//ADAIIB 

00  0SN-4USER.. ADA. LIBRARY .OISP-SHR 

//ADAOBJ 

00  0SN-4USER. .OBJ,DISP-(HOO,CATLG,CATLG) , 

// 

0CB* ( fl  ECFN-FB , LRECL-80 , BLKS I ZE-3 120 .0S0RG-P0 , BUFN0-4 ) , 

// 

SPACE-(80, (16090, 16000,20)) .UNIT-4SYS0A 

//AOAMAP 

00  0SN-&USER. .A0ANAP, 0ISP-(M0D,CATLG,CATLG) , 

// 

0CB- ( RECFM-V8 , LRECL- 1023 , BLKSI ZE-3 120 , DS0RG-P0 , BUFN0-2) , 

// 

SPACE- ( 1 32 , ( 1000 , 2000 , 20) ) , UN I T-&SYSDA 

//AOAOMAP 

00  0SN-4USER . . DEBUGMAP , D ISP- (MOO , CATLG , CATLG) , 

// 

0CB- ( RECFM- V8 , LRECL- 1023 , BLKS I ZE-3 120 , OSORG-PO , BUFNO-2 ) , 

// 

SPACE-( 132, (1000, 2000, 20)), UNI T-4SYSDA 

//AOALIST 

00  0SN-&USER. . LISTING, DISP-(MOD, CATLG, CATLG) , 

// 

0C8- ( RECFM-VBA , LRECL-259 , BLKS I ZE-3 120 , OSORG-PO , BUFNO-2 ) , 

// 

SPACE-( 132, (500,2000,20) ) .UNIT-4SYS0A 

//A0AUT1 

00  SPACE-( 132, (500,2000)), 

// 

OCB- ( RECFM-FB , LRECL- 136 , BLKS I ZE-3400 , OSORG-OA , BUFNO-2 ) , 

// 

UNIT-&SYSOA 

//A0AUT2 

00  SPACE-(132, (500,2000)), 

// 

OCB- ( RECFM- V8 , LRECL- 1 36 , BLKS IZE- 3 120 , OSORG-PS , BUFNO-2 ) , 

// 

UNIT-ftVIO 

//A0AUT3 

00  SPACE-(132, (500,2000)), 

// 

OCB- (RECFM-FB , LRECL- 1028 , BLKS I ZE-2056 , OSORG-OA .BUFNO-2) , 

// 

UNIT-4SYS0A 

//A0A0T4 

00  SPACE-( 132, (500,2000)), 

// 

OCB- (RECFM-FB , LRECL- 1 32 , BLKSI ZE-2640 , OSORG-OA , BUFNO-2 ) , 

// 

UNIT-&SYSOA 

Figure  3-2.  ADAS  Cataloged  Procedure 
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Symbolic  Variables  for  AOAB  Cataloged  Procedure 

The  AOAB  cataloged  procedure  includes  several  symbolic  JCL  substitution 
variables  you  can  modify  to  specify  the  various  options  available. 


Symbolic 

Variable 

BNDPRM 

MAXTIME 

MEMSIZE 

STPUB 

SYSDA 

SYSOUT 

UNIT 

USER 

VIO 


Description 

Specifies  options  to  the  binder  in  the  parm  field.  A  list  of  options 
you  can  specify  in  BNDPRM,  along  with  a  syntax  diagram,  appears 
in  "Binder  Options  for  Use  with  ADAB  Cataloged  Procedure '  on 
page  3-5. 

Sets  a  maximum  amount  of  time  for  the  binder  job  step  to  run 
(using  the  time  parameter  on  a  JCL  EXEC  card).  The  default  value 
is  60  minutes,  but  can  be  changed  when  the  cataloged  procedure 
is  installed. 

Specifies  the  amount  of  memory  in  which  to  run  the  binder  job 
step  (using  the  REGION  option  on  a  JCL  EXEC  card).  The  greater 
the  memory,  the  better  the  binder's  performance.  The  default 
value  is  SI 96Kb.  but  this  value  may  be  changed  when  you  install 
the  cataloged  procedure. 

Indicates  the  data*set  name  of  the  partitioned  data  set  that 
contains  the  binder  module.  MVSBINOE.  The  default  is  the  load 
library-AOA  LOAOL1B  but  you  can  change  this  default  when  you 
install  the  cataloged  procedure. 

Specifies  the  UNIT  for  permanent  data  set  allocations.  The 
default  is  SYSALLDA.  but  this  name  can  be  changed  depenoing  on 
your  site's  conventions. 

Identifies  the  output  class  for  the  binder  output.  The  default  is 
but  this  default  can  be  changed,  depending  on  your  site's 
conventions. 

Indicates  the  compilation  unit  to  be  bound.  You  must  specify  this 
variable 

Indicates  the  high-level  qualifier  level  qualifier  required  to  build 
data  set  names  used  by  the  binder.  You  must  specify  this 
variable.  It  is  common  to  set  it  to  your  TSO  logon  identifier. 

Specifies  the  UNIT  for  temporary  data  set  allocations.  The  default 
is  VIO.  but  this  default  can  be  changed  depending  on  your  site's 
conventions 
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Binder  Options  for  Use  with  ADAB  Cataloged  Procedure 

This  section  defines  the  standard  options  for  the  BNDPRM  symbolic  substitution 
variable.  This  variable,  found  in  STEP2  of  the  AOAB  cataloged  procedure, 
specifies  options  to  the  binder  in  the  FARM  field 

The  binder  options  have  the  following  syntax: 


r 

— upi  lUffJ 

i  '  " 

— (- modifiers — 

-)- 

Tabie  3-1  lists  the  valid  options,  their  modifiers,  and  defaults.  Descriptions  of 
the  options  appear  on  the  pages  shown. 


Table  3-1  Binder  Options  for  JCL 

Option 

OefauH 

Function 

Page 

ASM 

NOASM 

Assembly  listing. 

2-9 

[NOGEN 

Suppress  listing  of  expanded  generics. 

1  NOSYS] 

Suppress  listing  of  system-supplied  generics. 

OONAMES 

old a  me  -  new  _n  a  me 

Specify  the  Data  Description  [DO)  names  that  identify 
the  data  sets  used  by  the  compiler  and  binder  It 
must  include  at  least  one  modifier. 

2-12 

DEBUG 

NOOEBUG 

Output  information  for  debugging. 

2-13 

MAP 

NONAP 

Produce  linkage  map  during  binding. 

2-17 

TRACE 

NOTRACE 

Display  diagnostic  messages  from  the  compiler  Only 
for  use  in  submitting  problems  to  IBM. 

2-19 

Linking  Programs  that  Call  Non-Ada  Routines 

Pragma  Interface  enables  Ada  compilation  units  to  call  non-Ada  routines.  The 
following  sections  show  you  how  to  compile  and  link  programs  that  take 
advantage  of  this  feature. 

User-written  routines  do  not  reside  in  the  Ada  library  system.  The  only  method 
available  to  connect  non-Ada  routines  with  the  Ada  routines  that  call  them  is  to 
load  them  under  VM/CMS  or  link-edit  them  under  MVS  A  call  to  a  non-Ada 
routine  results  in  the  generation  of  an  external  reference.  This  external 
reference  is  unresolved  following  normal  AOA  processing.  You  must  take  special 
steps  in  order  to  resolve  virtual  address  constants  to  non-Ada  routines. 
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Under  VM/CMS 

The  following  table  explains  the  data  sets  used  in  calling  non-Ada  routines 


Table  3-2.  VM/CMS  Files  Used  in  Calling  Non-Ada  Routines 

File 

Description  j 

TEST  AOA  A 

File  containing  source  for  the  mam  program.  1 

TEST 

Compilation  unit  name. 

TEST  TEXT  A 

File  containing  the  object  code  of  the  Ada  routines. 

ROUTINE  TEXT  A 

File  containing  the  object  code  of  the  non-Ada  routines 

The  following  example  shows  the  correct  procedure  for  compiling  and  linking 

AOA  TEST  (MAIN  NORUN 
LOAD  TEST  ROUTINES 
GENMOD  TEST 

The  AOA  command  creates  the  object  file  TEST  TEXT  A  The  LOAD  loads  the 
object  files  TEST  TEXT  and  ROUTINES  TEXT  into  virtual  storage  and  establishes  the 
proper  linkages  between  them.  The  order  in  the  LOAD  is  important.  The  Ada 
module  must  go  first.  The  GENMOD  command  uses  the  two  object  files  to  create 
a  load  module  with  the  name  TEST  MODULE  A 

You  may  need  to  precede  the  commands  in  this  example  with  a  GLOBAL  TXTUB 
command  to  resolve  any  missing  external  references  from  the  LOAD  command. 
The  need  for  its  use  depends  on  how  you  load  the  non-Ada  routines.  For  more 
information  on  the  GLOBAL  command,  see  the  Virtual  Machine! System  Product 
CMS  Command  and  Macro  Reference. 


Under  MVS 

Non-Ada  routines  do  not  reside  in  the  Ada  library  system  The  only  method 
available  to  connect  non-Ada  routines  with  the  Ada  routines  that  call  them  is  to 
link-edit  them  A  call  to  a  non-Ada  routine  results  in  the  generation  of  an 
external  reference.  This  external  reference  is  unresolved  following  normal  ADA 
processing.  You  must  take  special  steps  in  order  to  resolve  virtual  address 
constants  to  non-Ada  routines.  This  section  explains  those  steps. 

The  following  table  explains  the  data  sets  used  in  calling  non-Ada  routines. 


Table  3-3  1 Page  f  of  2)  MVS  Oata  Sets  Used  in  Calling  Non- Ada  Routines 

Oata  Set 

Description 

qualifier  1£ST.A0A 

Data  set  containing  source  for  the  mam  program, 
whose  compilation  unit  name  is  Test. 

qualifier  NONADA.OBJ 

Data  set  containing  the  object  code  of  the  non-Ada 
routines. 

qualifier  OBJ 

Partitioned  data  set  containing  the  object  code  of  the 

Ada  routines. 

qualifier  LOAO 

Partitioned  data  set  containing  the  executable  load 
modules:  also  called  the  “load  library." 

There  are  two  methods  for  compiling  and  linking  an  Ada  program  with  non-Ada 
routines.  The  first  involves  binding  with  NOGenerate.  then  linking  the  foreign 
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language  code  manually  with  the  linkage  editor.  The  second  involves  placing 
the  code  in  a  partitioned  data  set  (PCS)  such  that  the  object  goes  into  the  obiect 
library  created  by  the  Bind  option.  The  following  two  examples  show  how  to  use 
these  methods. 

Using  the  Unkage  Editor 

First  compile  the  main  program,  using  the  NOGenerate  option. 

EX  'AOA.CLIST(AOA) 1  'TEST. ADA  (MAIN  NOGENERATE' 

This  member  contains  one  or  more  unresolved  references  to  non-Ada  code.  The 
following  call  to  the  linkage  editor  resolves  the  unresolved  external  references 
associated  with  those  calls. 

LINK  ( ' USERl . NONAOA. OB J ' , ' USER1 .OBJ ( TEST) ' ) 

The  TEST  load  library  member  is  now  fully  linked  and  ready  to  execute. 

Using  a  Partitioned  Data  Set 

If  you  choose  to  use  a  partitioned  data  set.  use  the  following  steps: 

1  Place  the  foreign  language  routine's  object  code  into  a  partitioned  data  set. 

2.  issue  the  TSO  ALLOC  command  for  a  00  name  of  SYSUB  and  then  associate 
this  with  the  POS  containing  the  non-Ada  object  code. 

ALLOC  OO(SYSLIB)  0A( 'USERl. NONAOA. OBJ')  SHR 

3.  Bind  the  main  program  (or  compile  and  bind)  without  using  the  NOGenerate 
option  The  LINK  within  AOA  will  refer  to  the  SYSUB  allocation  as  it  attempts 
to  resolve  references  to  the  non-Ada  routines. 

The  TEST  load  library  member  is  now  fully  linked  to  be  executed. 

For  more  information  on  LINK,  see  the  UNK  command  in  the  IBM  publication. 
MVS/Extended  Architecture  TSO  Extensions  TSO  Command  Language  Reference. 


Chapter  3.  Binding  and  Linking  an  Ada  Program 


3-7 


Linking  Programs  that  Call  Non-Ada  Routines 


3*8  IBM  Ads/370 


APPENDIX  C 


APPENDIX  F  OF  THE  Ada  STANDARD 


The  only  allowed  implementation  dependencies  correspond  to 
implementation-dependent  pragmas,  to  certain  machine-dependent  conventions 
as  mentioned  in  Chapter  13  of  the  Ada  Standard,  and  to  certain  alloved 
restrictions  on  representation  clauses.  The  implementation-dependent 
characteristics  of  this  Ada  implementation,  as  described  in  this  Appendix, 
are  provided  by  the  customer.  Unless  specifically  noted  otherwise, 
references  in  this  Appendix  are  to  compiler  documentation  and  not  to  this 
report.  Implementation-specific  portions  of  the  package  STANDARD,  which 
are  not  a  part  of  Appendix  F,  are: 


package  STANDARD  is 

type  INTEGER  is  range  -2_147  483  648  ..  2  147  483  647; 

.  type  SHORT_INTEGER  is  range  -32_768  . .  32~767? 

type  FLOAT  is  digits  6  range  -7.23701E+75  ..  7.23701E+75; 
type  LONG_FLOAT  is  digits  15  range  -7.23700557733225E+75 

..  7.23700557733225E+75; 

type  DURATION  is  delta  2#1.0#E-14  range  -86400.0  ..  86400.0; 
end  STANDARD; 


C-l 


to  specify  the  relative  urgency  of  each  MVS  task  created. 

♦♦PRAGMA  ALLOCATION_DATA 

(<  access  _type>, 

<residence_mode> , 

<  allocation  ^duration  > , 

<subpool  number  >, 

<discrete  user  data>); 

to  associate  MVS  virtual  storage  attributes  with  an  Ada  access  type. 

♦Note  that  PRAGMA  INLINE  is  effective  only  when  the  optimising  option  is  selected  at 
compile  time.  If  optimizing  is  not  selected  the  pragma  is  ignored  and  a  warning  is  issued. 

•♦Note  that  PRAGMA  OS  TASK  and  PRAGMA  ALLOCATION  DATA  are  effective  only 
when  compiling  for  an  MVS  target.  Both  pragmas  require  that  an  MVS  runtime  be  present. 


2.  Implementation-Defined  Attributes 

2.1.  Integer  Type  Attributes 

Extended_Image  (  Item,  <Width>,  <Base>,  <Based>,  < SpacelF  Positive >  ); 

to  return  the  image  associated  with  Item  as  defined  in  Text_IO.Integer_IO.  The  Text_IO 
definition  states  that  the  value  of  Item  is  an  integer  literal  with  no  underlines,  no  exponent, 
no  leading  zeroes  (but  a  single  zero  for  the  zero  value),  and  a  minus  sign  if  negative. 

Extended_Value  (Item); 

to  return  the  value  associated  with  Item  as  defined  in  Text_IO.Integer_IO.  The  Text_IO 
definition  states  that  given  a  string,  it  reads  an  integer  value  from  the  beginning  of  the 
string.  The  value  returned  corresponds  to  the  sequence  input. 

Extended_Width  (  <Base>,  <Based>,  <Space  IF  Positive>  ); 
to  return  the  width  for  a  subtype  specified. 

2.2.  Enumeration  Type  Attributes 
Extended_Image  (  Item,  <Width>,  <Uppercase>); 

to  return  the  image  associated  with  Item  as  defined  in  Text_IO.Enumeration_IO.  The 
Text_IO  definition  states  that  given  an  enumeration  literal,  it  will  output  the  value  of  the 
enumeration  literal  (either  an  identifier  or  a  character  literal).  The  character  case 
parameter  is  ignored  for  character  literals. 

Extended_Value  (  Item  ); 

to  return  the  image  associated  with  Item  as  defined  in  Text_IO.Enumeration_IO.  The 
Text_IO  definition  states  that  it  reads  an  enumeration  value  from  the  beginning  of  the  given 
string  and  returns  the  value  of  the  enumeration  literal  that  corresponds  to  the  sequence 
input. 

Extended  _Wid  th ; 

to  return  the  width  for  a  specified  subtype. 


2.3.  Floating  Point  Attributes 

Extendedlmage  (  Item,  <Fore>,  <Aft>,  <Exp>,  <Base>,  < Based >  ); 

to  return  the  image  associated  with  Item  as  defined  in  Text_!O.Float_IO.  The  Text_IO 
definition  states  that  it  outputs  the  value  of  the  parameter  Item  as  a  decimal  literal  with 
the  format  defined  by  the  other  parameters.  If  the  value  is  negative,  a  minus  sign  is 
included  in  the  integer  part  of  the  value  of  Item.  If  Exp  is  0,  the  integer  part  of  the  output 
has  as  many  digits  as  are  needed  to  represent  the  integer  part  of  the  value  of  Item  or  is  zero 
if  the  value  of  Item  has  no  integer  part. 

Extended_Value  (  Item  ); 

to  return  the  value  associated  with  Item  as  defined  in  Text_IO.Floa.t_IO.  The  Text  10 
definition  states  that  it  skips  any  leading  zeroes,  then  reads  a  plus  or  minus  sign  if  present, 
then  reads  the  string  according  to  the  syntax  of  a  real  literal.  The  return  value  is  that 
which  corresponds  to  the  sequence  input. 

Extended_Digits  (  <Base>  ); 

to  return  the  number  of  digits  using  base  in  the  mantissa  of  model  numbers  of  the  specified 
subtype. 

2.4.  Fixed  Point  Attributes 

Extended  lmage  (  Item,  <Fore>,  <Aft>,  <Exp>,  <Base>,  < Based >  ); 

to  return  the  image  associated  with  Item  as  defined  in  TextIO.FixedlO.  The  Text_IO 
definition  states  that  it  outputs  the  value  of  the  parameter  Item  as  a  decimal  literal  with 
the  format  defined  by  the  other  parameters.  If  the  value  is  negative,  a  minus  sign  is 
included  in  the  integer  part  of  the  value  of  Item.  If  Exp  is  0,  the  integer  part  of  the  output 
has  as  many  digits  as  are  needed  to  represent  the  integer  part  of  the  value  of  Item  or  is  zero 
if  the  value  of  Item  has  no  integer  part. 

Extended_Value  (  Image  ); 

to  return  the  value  associated  with  Item  as  defined  in  Text_IO.Fixed_IO.  The  Text  IO 
definition  states  that  it  skips  any  leading  zeroes,  reads  a  plus  or  minus  sign  if  present,  then 
reads  the  string  according  to  the  syntax  of  a  real  literal.  The  return  value  is  that  which 
corresponds  to  the  sequence  input. 

Extended_Fore  (  <Base>,  <Based>  ); 

to  return  the  minimum  number  of  characters  required  for  the  integer  part  of  the  based 
representation  specified. 

Extended^Aft  (  <Base>,  <Based>  ); 

to  return  the  minimum  number  of  characters  required  for  the  fractional  part  of  the  based 
representation  specified. 

3.  Package  SYSTEM 

The  current  specification  of  package  SYSTEM  is  provided  below. 


With  Unchecked  _Con  version; 

package  System  is 


CUSTOMIZABLE  VALUES 


TYPE  Name  IS  (MC68000,  ANUYK44,  IBM370); 

System_Name  :  CONSTANT  name  :=  IBM370; 

Memory  Size  :  CONSTANT  :=  (2  **  24)-l; 

Tick  :  CONSTANT  1.0  /  (10  **  6); 


-  NON-CUSTOMIZABLE,  IMPLEMENTATION-DEPENDENT  VALUES 


Storage_Unit  :  CONSTANT  :»  8; 

Minlnt  :  CONSTANT  :=  -(2  **  31); 

Maxlnt  :  CONSTANT  :=  (2  **  31)  -  1; 

Max  Digits  :  CONSTANT  :=*=  15; 

MaxMantissa  :  CONSTANT  :*  31; 

Fine_Delta  :  CONSTANT  :=  1.0  /  (2  **  Max_Mantissa  ); 

Subtype  Priority  IS  Integer  RANGE  0  ..  255; 


-  ADDRESS  TYPE  SUPPORT 


type  Memory  is  private; 
type  Address  is  access  Memory; 

Null_Address  :•  Constant  Address  :=  null; 

type  Address_Value  is  RANGE  -(2**31)  ..  (2 **31)-1; 

Hex_80000000  :  constant  Address_Value  :=  -  16^80000000#; 
Hex_90000000  :  constant  Address_Value  :=  -  16#70000000#; 
Hex_A0000000  :  constant  Address_Value  :=  -  16#60000000#; 
Hex_BOOOOOOO  :  constant  Address_Value  -  16#50000000#; 
Hex_c0000000  :  constant  Address_Value  :=  -  16#40000000#; 
Hex_D0000000  :  constant  Address_Value  -  16#30000000#: 

Hex  EOOOOOOO  :  constant  Address_Value  :=  -  16#20000000#; 

Hex  FOOOOOOO  :  constant  Address_Value  :=  -  1 6#  10000000# ; 

function  Location  is  new  Unchecked_Conversion  (Address_Value,  Address); 

function  Label  (Name:  String)  return  Address; 
pragma  Interface  (META,  Label); 


-  CALL  SUPPORT 


type  Subprogram_Value  IS 
record 

Procaddr  :  Address; 

Parent^frame  :  Address; 
end  record; 

Max  Object _Sise  :  CONSTANT  :*  Max_Int; 

Max  Record _Count  :  CONSTANT  Max  lnt; 

Max_Text_Io_Count  :  CONSTANT  Max  Int-1; 

Max  Text  Jo  Field  :  CONSTANT  1000;  ~ 

private 

type  Memory  is 
record 
null; 

end  record; 
end  SYSTEM; 

4.  Representation  Clauses 

This  implementation  supports  address,  length,  enumeration,  and  record  representation 
clauses  with  the  following  exceptions: 

Address  clauses  are  not  supported  for  package,  for  entry,  for  tasktype,  for 
subprograms. 

Enumeration  clauses  are  not  supported  for  boolean  representation  clauses. 

The  size  in  bits  of  representation  specified  records  is  rounded  up  to  the  next  highest  multiple 
of  8,  meaning  that  the  object  of  a  representation  specified  record  with  25  bits  will  actually  occupy 
32  bits. 

Nonsupported  clauses  are  rejected  at  compile  time. 

5.  Implementation- Generated  Names 

There  are  no  implementation-generated  names  denoting  implementation-dependent 
components.  Names  generated  by  the  compiler  shall  not  interfere  with  programmer-defined 
names. 

6.  Address  Clause  Expression  Interpretation 

Expressions  that  appear  in  Address  clauses  are  interpreted  as  virtual  memory  addresses. 

7.  Unchecked  Conversion  Restrictions 

Unchecked_Conversion  is  allowed  except  when  the  target  data  subtype  is  an  unconstrained 
array  or  record  type.  If  the  size  of  the  source  and  target  are  static  and  equal,  the  compiler  will 
perform  a  bitwise  copy  of  data  from  the  source  object  to  the  target  object. 


Where  the  sizes  of  source  and  target  differ,  the  following  rules  will  apply: 

•  If  the  size  of  the  source  is  greater  than  the  size  of  the  target,  the  high  address  bits  will 
be  truncated  in  the  conversion. 

•  If  the  size  of  the  source  is  less  than  the  size  of  the  target,  the  source  will  be  moved  into 
the  low  address  bits  of  the  target. 

The  compiler  will  issue  a  warning  when  UncheckedjConversion  is  instantiated  with  unequal 
sizes  for  source  and  target  subtype.  Unchecked_Conversion  between  objects  of  different  or  non¬ 
static  sizes  will  usually  produce  less  efficient  code  and  should  be  avoided,  if  possible. 

8.  Implementation-Dependant  Characteristics  of  the  I/O  Packages 

•  Sequential_IO,  Direct_IO,  and  Text ^10  are  supported. 

•  Low_Level_IO  is  not  supported. 

•  Unconstrained  array  types  and  unconstrained  types  with  discriminants  may  not  be 
instantiated  for  I/O. 

•  File  names  follow  the  conventions  and  restrictions  of  the  target  operating  system. 

•  In  Text_IO,  the  type  Field  is  defined  as  follows:  subtype  Field  is  integer  range 

0..1000; 

•  In  Text_IO,  the  type  Count  is  defined  as  follows:  type  Count  is  range 
0..2  147  483  646; 


